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Sorting  also  is  an  aid  to  searching  ... 
and  therefore  it  helps  to  make  computer  output 
more  suitable  for  human  consumption.  In  fact,  a  listing 
that  has  been  sorted  into  alphabetic  order  often  looks  quite 
authoritative  even  when  the  associated  numerical  information 

has  been  incorrectly  computed. 

--  Donald  E.  Knuth 
" The  Art  of  Computer  Programming "  (1973) 


Introduction 


This  list  of  terms  was  generated  from  the  information  available  online  in  a  file 
built  to  be  read  by  an  automatic  question  answering  system  (the  "Help  Command"). 
In  generating  this  documentation  goal  has  been  to  produce  a  true  glossary,  to  be 
used  for  the  most  part  as  a  dictionary.  We  imagine  readers  who  are  studying  other 
NLS  documentation,  trying  to  recall  what  they  have  learned  in  classes  or  from 
co-workers,  or  are  working  online  and  want  to  supplement  the  Help  command. 
NLS  is  a  new  medium  with  extensive  new  terminology.  We  explain  terms  peculiar 
to  NLS,  and  in  some  cases  explain  terms  familiar  to  some  computer  users  but 
strange  to  the  increasing  number  coming  to  NLS  without  computer  background.  It 
is  possible  to  learn  about  NLS  by  browsing  in  this  glossary,  as  it  is  possible  to  learn 
about  English  by  browsing  in  a  dictionary,  but  only  in  a  somewhat  haphazard  way. 

The  source  of  the  material  and  the  small  size  of  the  vocabulary  (in  comparison 
to  the  number  of  words  in  a  natural  language)  limited  us  in  certain  ways.  One 
limitation  is  the  size  of  loops.  As  in  the  case  of  any  dictionary,  definitions  of  terms 
lead  to  definitions  of  other  terms  which  in  the  end  lead  back  to  the  first  term.  The 
size  of  these  loops  has  been  taken  as  the  measure  of  the  power  of  a  dictionary. 
Because  of  the  limited  size,  the  highly  cross-referenced  source  material,  and 
limitations  of  time,  the  loops  are  sometimes  rather  short  in  this  glossary. 

Those  familiar  with  the  hierarchical  arrangements  characteristic  of  NLS  will 
understand  that  it  was  difficult  to  level  our  information  out  to  form  an  alphabetic 
list.  The  location  of  command  is  a  case  in  point.  Should  the  command  "Delete 
Word"  be  indexed  under  Word?  under  Delete?  or  under  Base,  since  it  is  part  of  the 
Base  Subsystem?  In  the  end  we  alphabetized  all  commands  under  their  first  word, 
and  added  lists  of  commands  under  the  names  of  the  various  subsystems.  Because 
commands  to  Delete  exist  in  several  subsystems,  it  was  necessary  to  add  (BASE) 
after  the  reference  to  Delete  to  guide  the  reader  in  selecting  among  several  entries. 

A  similar  problem  appears  in  the  names  given  to  variables  that  appear  in  only 
one  or  a  few  commands.  For  example  in  the  "Show  Directory"  and  "Copy 
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Directory"  commands  a  user  may  optionally  choose  to  see  several  secondary  facts 
about  the  file.  The  choices  are  called  collectively  DIROPT  in  the  command  syntax. 
Where  should  DIROPT  appear  in  the  glossary?  Since  DIROPT  appears  in  the  the 
syntax  of  several  commands,  it  appears  alphabetically  under  D. 

Some  descriptions  have  references  such  as  "pointing:  See  pointing". 

Descriptions  cited  in  this  way  will  be  found  in  alphabetic  order  (under  P  in  the  case 
of  "pointing").  Unless  otherwise  noted,  a  command  description  refers  to  a 
command  in  the  BASE  subsystem. 

Comparison  of  the  content  of  definitions  in  the  Glossary  with  those  read  online 
with  the  Help  command  will  sometimes  reveal  differences.  In  most  cases  it  is 
because  the  online  version  is  more  up-to-date. 

This  experiment  in  generating  usable  offline  documentation  from  a  source 
optimally  formatted  for  online  viewing  will  be  repeated  in  the  future.  We  welcome 
suggestions  and  corrections.  Please  let  us  know  the  forms  and  media  best  suited  to 
provide  the  information  you  need  to  learn  and  use  NLS. 
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DEFINITIONS  AND  CONVENTIONS  IN  COMMAND  SYNTAX 


Terms  to  be  defined  are  in  Newsgothic  type,  as  are  TNLS  examples.  Definitions  are 
in  Times  Roman,  the  type  face  of  the  body  of  this  introduction.  Each 
commandword  begins  with  a  capital  letter,  and  the  rest  is  lower  case.  Words  in  all 
upper  case  are  variables,  that  stand  for  certain  alternatives  which  are  defined  either 
below  or  in  the  body  of  the  glossary.  Citations  to  other  parts  of  the  glossary  are  in 
slanted  type.  Paragraphs  that  are  subordinate  to  higher-level  definitions  are  indented 
and  in  smaller  type. 

Parentheses  (....)  bound  noise  words  echoed  by  system;  prompts  are  not  shown. 

/  means  or 

SUBSYSTEM  =  Base  /  Programs  /  Sendmail  /  Calculator  /  Useroptions 
(These  are  commandwords) 

STRING  =  Character  /  Word  /  Visible  /  Invisible  /  Number 
/  Link  /  Text 
(These  are  commandwords) 

STRUCTURE  =  Statement  /  Group  /  Branch  /  Plex 
(These  are  commandwords) 

ADDRESS: 

a  FILEADDRESS  and/or  an  INFILEADDRESS  ending  with  an  OK  (or  just  an  OK  in 
TNLS  for  prior  location).  FILEADDRESS  if  used  must  come  first.  Elements  of 
an  INFILEADDRESS,  if  more  than  one  are  used,  must  be  separated  by  <SP>. 
DESTINATION: 

In  TNLS:  DESTINATION  =  ADDRESS. 

In  DNLS:  DESTINATION  =  BUG  /  ADDRESS 

When  referring  to  Group  or  Text,  two  BUGS  or  two  ADDRESSES  are  needed. 
SOURCE: 

In  TNLS:  SOURCE  =  ADDRESS  /  OPTION  TYPEIN 

In  DNLS:  SOURCE  =  BUG  /  ADDRESS  /  OPTION  TYPEIN 

When  referring  to  Group  or  Text,  two  BUGS  or  two  ADDRESSES  are  needed. 

CONTENT: 

In  TNLS:  CONTENT  =  TYPEIN  /  OPTION  ADDRESS 
In  DNLS:  CONTENT  =  BUG  /  TYPEIN  /  OPTION  ADDRESS 
When  refering  to  Group  or  Text,  two  BUGS  or  two  ADDRESSES  are  needed. 
TYPEIN  =  a  string  of  characters  from  the  keyboard,  ending  with  an  OK. 

TYPEIN  has  a  special  form  when  a  FILEADDRESS  or  Link  or  Ident  is  called  for. 
(You  can  tell  from  the  noise  words.) 

OPTION  =  the  <CTRL-U>  character 
LEVEL-ADJUST: 

a  lowercase  d  (for  down)  or  one  or  more  lowercase  u’s  (for  up),  optionally 
terminated  by  a  <SP>  or  OK;  if  you  ignore  the  LEVEL-ADJUST  and  start  typing 
the  level  will  be  the  same. 

VIEWSPECS: 

Type  a  string  of  any  of  the  viewspec  codes,  terminated  by  an  OK,  or  just  type 
an  OK  if  you  don’t  want  to  change  the  viewspecs. 

ANSWER:  Type  y  for  yes  or  n  for  no 

You  may  usually  type  OK  here.  The  command  will  be  immediately  executed. 
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OK:  CA  /  OKINSERT  /  OKREPEAT 

CA:  Command  Accept:  confirms  a  command  or  terminates  a  field  within  a 
command. 

DNLS  default  special  character:  CA/<CTRL-D> 

TNLS  default  special  character:  CR/<CTRL-D> 

OKINSERT:  At  the  end  of  a  command  in  Base  subsystem  only,  executes  the 
command  and  starts  "Insert  Statement"  command,  defaulting  current 
location.  Then  you  do:  LEVEL- ADJUST  CONTENT  OK.  INSERT  mode 
continues  until  you  type  CD.  In  all  other  cases,  OKINSERT  has  no  special 
meaning;  it  is  equivalent  to  Command  Accept, 
default  special  character:  <CTRL-E> 

OKREPEAT:  At  the  end  of  any  command,  executes  it  and  repeats  it  from 
the  beginning,  defaulting  each  command-word  until  reaching  the  first  field 
not  a  commandword  that  you  can  specify.  Then  you  take  over  the 
command.  REPEAT  mode  continues  until  you  type  CD.  Used  elsewhere, 
OKINSERT  has  no  special  meaning;  it  is  equivalent  to  Command  Accept. 
DNLS  default  special  character:  <CTRL-B> 

CD:  Command  Delete.  It  aborts  a  command  immediately  and  will  also  take  you 
out  of  INSERT  or  REPEAT  mode. 

default  special  character:  <CTRL-X> 
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a  ViewspeC:  show  one  level  less:  "Show  one  less  level  than  was  previously 
shown."  This  viewspec  will  change  or  modify  viewspecs  w  and  c  (counting  back 
from  the  deepest  level),  x  and  d  (you  won’t  see  anything),  e  (one  less  than  the 
level  of  the  statement  you  are  currently  at)  and  b  (each  a  cancels  out  one  b). 

A  Viewspec:  level  indenting  on:  "Indent  each  level  more  than  the  last  level." 
The  number  of  spaces  each  level  is  indented  is  usually  3,  but  you  can  specify  it 
with  the  Useroptions  command  Printoptions  Indenting.  This  viewspec  changes 
viewspec  B  and  Q.  This  is  a  default  viewspec.  See  also:  Level,  Capital -B, 
Capital-Q,  Printoptions  (USEROPTIONS). 

A-COlon:  A:  ADDRESS:  See  address. 

Accept  Connect  (from  terminal  number)  (for)  CONTENT  OK:  The 

command  "Accept  Connect  (from  terminal  number)"  allows  someone  at  the 
terminal  number  you  specify  for  CONTENT  to  control  your  job  as  if  he  were 
you.  Use  the  TENEX  WHERE  command  to  learn  the  terminal  (TTY)  number. 

TNLS  example: 

BASE  C:  Accept  C:  Connect  (from  terminal  number)  T /  [  A  ] :  5(for)  C:  Output  (Only)  OK: 

BASE  C: 

access: 

to  files:  See  accessing. 

to  ARC:  Centering. 

accessing  files:  going  to  a  file  to  read  it  or  write  on  it.  Wherever  an  ADDRESS 
is  prompted  by  A:  you  can  go  to  a  particular  file  whose  FILEADDRESS  you 
know-type  it  in.  You  can  also  use  the  Load  File  command  to  open  a  file  for 
read  or  write  access.  By  pointing  to  a  link  you  can  access  the  file  it  specifies.  A 
record  of  the  files  you  have  been  in  during  your  current  NLS  session  is 
remembered,  and  the  past  10  files  can  be  accessed  with  the  Jump  File  Return 
command,  or  File  Return  ring  for  a  maximum  of  25  files.  The  file-return  ring 
provides  another  method  of  accessing  those  files  easily  with  the  Jump  File  Return 
command.  When  you  use  the  Create  File  command  in  NLS,  the  new  file  is 
immediately  loaded  for  you.  Access  to  files  may  be  protected. 

Load  File  command  in  Base:  &?eLoad. 

Jump  to  Link  command:  See  Jump  Link. 

file-return  ring:  See  Return. 

privacy  provisions:  See  Privacy. 

accesslist:  See  Set  NLS  Private. 
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account:  an  assigned  number  or  string  to  which  your  work  is  charged.  You  accept 
a  default  account  number  by  responding  with  a  carriage  return  when 
"(ACCOUNT)"  is  requested  during  the  login  process. 

accumulator:  Accumulators  contain  a  number  representing  a  calculated  value  such 
as  a  total.  You  may  keep  several  running  totals  in  separate  accumulators.  The 
Clear  command  clears  an  accumulator.  The  Use  command  specifies  an 
accumulator  other  than  your  current  accumulator.  The  Insert  command  inserts 
the  value  in  the  accumulator  at  the  DESTINATION  you  specify.  The  Replace 
command  replaces  the  number  at  the  DESTINATION  you  specify  with  the  value 
in  the  accumulator.  The  Evaluate  command  allows  you  to  use  the  value  in  an 
accumulator  by  typing  that  accumulator’s  number  preceded  by  a  number  sign 
thus:  #1. 

The  Calculator  Use  command:  See  use  (CALCULATOR). 

The  Calculator  Insert  command:  See  insert  (CALCULATOR). 

The  Calculator  Replace  command:  See  replace  (CALCULATOR). 

The  Calculator  Evaluate  command:  See  evaluate  (CALCULATOR). 

Add  CONI  ENT  OK:  The  Calculator  subsystem  command  "Add"  adds  the 
number  you  specify  for  CONTENT  to  the  accumulator.  Then  the  accumulated 
total  is  ready  for  the  next  operation.  See  also:  operators,  accumulator, 
CONTENT,  OK. 

ADDRESS:  prompted  by  A,  asks  you  to  specify  a  point  in  a  file.  It  can  be  a 
sequence  (ending  with  your  CA)  of  one  or  more  elements  separated  by  spaces. 
Each  element  moves  you  to  a  new  position  relative  to  your  prior  position.  If  any 
of  the  elements  are  incorrect,  the  entire  address  fails.  In  TNLS,  you  can  specify 
your  current  location  by  giving  your  CA  when  prompted  for  an  ADDRESS.  A 
link  is  an  ADDRESS  written  in  a  file.  In  appropriate  commands,  you  can  point 
to  the  link  instead  of  writing  out  the  address.  See  also:  pointing, 

INFILEADDRESS. 

FILE  ADDRESS:  SITE,  DIRECTORY,  FILENAME,  altmode,  escape.  See  FILEADDRESS. 

addressing:  See  pointing. 

AHI:  Acronym  for  Augmentation  of  Human  Intellect,  a  former  name  for  ARC. 

AKW:  Augmented  Knowledge  Workshop. 

allocation:  file  space  allocation:  the  fixed  amount  of  disk  pages  for  each  directory. 
When  there  are  not  enough  pages,  the  message:  "File  space  allocation  exceeded" 
will  appear.  At  this  time,  the  user  must  Trim,  or  Delete,  and  Expunge  files. 

Showing  your  disk  status:  5eeshow  disk  (BASE). 

expunging:  See  Expunge. 

alpha-numeric:  See  character. 

alphanumeric:  See  character. 

alt:  Sec  esc. 
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alternatives:  when  it  is  possible  to  do  one  of  several  things  for  a  specific  part  of  a 
command.  In  prompts,  alternatives  are  always  separated  by  slashes  (/).  For 
example,  when  you  use  the  command  Update  File,  you  are  prompted  with  OK/C: 
This  shows  you  have  two  alternative  commands  available  to  you.  Do  not  confuse 
alternatives  with  options.  Options  are  parts  of  a  command  that  you  must  type 
<  CTRL-U  >  to  use. 

altmode:  5ee<ESC>. 

Ampersand:  &:  a  character  used  for  various  special  functions: 

setting  the  distribution  of  journal  items  for  groups:  See  restricted  (SENDMAIL). 
using  an  externalname  in  an  ADDRESS:  See  externa  I  name, 
address  files  on  filereturn  rings  changed  to  .fr:  5eefr. 

Anglebrackets: 

to  delimit  links:  See  link. 

typing  the  key  "<"  shows  your  previous  subsystems:  Seelessthan. 
typing  the  key  ">"  shows  your  current  subsystem:  See  greaterthan . 
to  represent  invisible  characters:  See  Invisible. 

ANSWER:  The  part  of  a  command  when  NLS  wants  a  yes  or  no  answer.  Type  a 
"y"  or  an  OK  for  "yes"  or  an  "n"  for  "no."  "Yes"  proceeds  through  the 
command;  "no"  cycles  you  back  through  part  of  the  command.  If  prompting  is 
on  NLS  prompts  you  "Y/N: 

Anticipatory:  a  recognition  mode  where  each  commandword  will  be  completed 
after  you  type  enough  letters  to  uniquely  define  it.  You  may  NOT  type  more 
than  the  minimum  number  of  letters,  since  the  commandword  will  have  been 
recognized  and  the  extra  characters  will  go  into  the  next  field.  Example:  "Se"  is 
enough  to  recognize  the  command  Set.  If  you  type  "Set,  "  the  "t"  would  be 
read  as  the  next  part  of  the  command.  The  command  would  be  interpreted  as  Set 
TENEX. 

Append  Statement  (at)  SOURCE  (to)  DESTINATION  (join  with)  CONTENT  OK: 
The  command  "Append"  attaches  one  statement  to  another.  The  appended 
statement  is  added  to  the  end  of  the  receiving  statement.  You  may  only  append 
statements.  Any  substructure  under  the  statement  to  be  appended  will  appear 
before  any  substructure  under  the  receiving  statement.  The  characters  you  specify 
to  "join  with"  for  CONTENT  will  be  inserted  between  the  two  statements  (if 
you’re  in  TNLS  and  don’t  want  anything  inserted,  just  give  a  Command  Accept 
for  CONTENT;  for  DNLS  use  <CTRL-N>).  After  execution  you  are  at  the  last 
character  of  the  receiving  statement  (the  character  preceding  the  appended 
material). 

TNLS  example: 

BASE  C:  Append  C:  Statement  (at)  A/[T]:  Ibll(to)  A:  lblO(join  with)  T/ [ A ] :  and 
furthermore 
BASE  C: 

APR:  Acronym  for  the  Arithmetic  Processor  of  the  PDP-10. 
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ARC:  acronym  for  Augmentation  Research  Center:  ARC  is  a  laboratory  within 
SRI  located  at  333  Ravenswood  Avenue,  Menlo  Park  Calif.,  94025  (415) 

326-6200  Extension  3660.  See  also:  Augmentation. 

Architect:  The  person  assigned  to  Augmented  Knowledge  (AKW)  Workshop  user 
communities  responsible  for  matching  the  tools  of  the  AKW  with  the  needs  of 
that  user  community. 

Archive  File  CONTENT  [  (opt:)ARCHIVEOPT]  OK:  The  command  "Archive 
File"  permits  you  to  store  Files  on  tape  to  save  disk  space.  With  this  command, 
you  can  mark  the  File  you  specify  for  CONTENT  to  be  archived  tonight  or  never 
to  be  archived.  Retrieval  takes  15  minutes  to  half  an  hour.  Files  unread  for  a 
few  weeks  are  archived  automatically.  Check  with  your  computer’s  operator  to 
determine  the  exact  date. 

ARCHIVEOPT  = 

Delete  (after  archiving  Finished?)  ANSWER:  The  Archive  File  command  option  "Delete" 
undoes  the  Prevent  option.  This  is  the  default  case.  Another  ARCHIVEOPT  is  expected  if 
you  type  "n"  for  ANSWER. 

Prevent  (deletion  after  archiving  Finished?)  ANSWER:  The  Archive  File  command  option 
"Prevent"  will  mark  the  file  you  specified  to  be  archived  but  leave  it  online  after  it  is  archived. 
This  command  will  not  affect  a  file  that  has  already  been  archived  or  that  has  just  been 
retrieved  from  archive.  You  must  create  a  new  version  for  this  command  to  have  effect. 
Another  ARCHIVEOPT  is  expected  if  you  type  "n"  for  ANSWER. 

Not  (allowed  Finished?)  ANSWER:  The  Archive  File  command  option  "Not"  will  prevent  the 
file  you  specified  from  being  copied  onto  tape  if  it  is  not  read  after  several  weeks.  This 
command  will  not  affect  a  file  that  has  already  been  archived  or  that  has  just  been  retrieved 
from  archive.  You  must  create  a  new  version  for  this  command  to  have  effect.  Another 
ARCHIVEOPT  is  expected  if  you  type  "n"  for  ANSWER. 

Deferred  (Finished?)  ANSWER:  The  Archive  File  command  option  "Deferred"  will  mark  the 
file  you  specify  for  CONTENT  to  be  copied  onto  tape  if  it  is  not  read  after  several  weeks. 
Another  ARCHIVEOPT  is  expected  if  you  type  "n"  for  ANSWER. 

Immediate  (Finished?)  ANSWER:  The  Archive  File  command  option  "Immediate"  will  mark 
the  file  you  specify  for  CONTENT  to  be  copied  onto  tape  tonight.  Another  ARCHIVEOPT  is 
expected  if  you  type  "n"  for  ANSWER. 

Reset  (request  status  Finished?)  ANSWER:  The  Archive  File  command  option  "Reset"  will 
mark  the  file  to  be  archived  and  deleted  if  it  is  not  read  for  several  weeks. 

Archived  file:  a  File  that  has  been  copied  ofT  of  the  disk  onto  tape  via  the  Archive 
system. 

Retrieve  command:  See  Retrieve. 

Archive  command:  See  Archive. 

archiving-commands: 

Archive  File:  See  Archive. 

Reset  Archive  (request  for  file):  See  Reset  archive. 

Undelete:  See  Undelete. 

arithmetic  operations:  The  calculator  works  on  the  value  in  the  current 
accumulator.  An  arithmetic  operation  requires  as  input  an  operator  (  +  ,  -,  x,  or  /) 
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followed  by  a  signed  or  unsigned  number  or  an  accumulator  designated  with  the 
Use  command.  The  number  may  be  entered  directly  from  the  keyboard  or 
indirectly  as  a  simple  arithmetic  expression  (e.g.:  1+5-6/15),  or  by  a  BUG  or 

ADDRESS.  If  you  omit  the  operator,  the  system  adds  the  number  to  the 
accumulator.  See  also:  accumulator,  Use,  BUG,  ADDRESS. 

input  is  handled  as  follows:  See  Input. 

numbers  recognizable  to  the  Calculator:  See  Numbers. 

expressions:  arithmetic  expressions:  See  Evaluate. 

Arithmetic  — Processor:  The  central  processing  unit  of  the  PDP-10. 

ARPA:  Acronym  for  the  Advanced  Research  Projects  Agency  of  the  Department  of 
Defense.  It  is  also  called  DARPA  which  stands  for  Defense  Advanced  Research 
Projects  Agency. 

ARPANET:  Official  acronym  for  the  ARPA  Computer  Network. 

Server  computer:  See  Server. 

User  computer:  See  User. 

ARPA:  Acronym  for  the  Advanced  Research  Projects  ...  See  ARPA. 

Packet:  strings  of  bits  bounded  by  routing  ...  See  Packet. 

Subnet:  The  array  of  IMPs,  TIPs  and  communication  ...  See  Subnet. 

asterisks:  See  Stars. 

Attach  Subsystem  SUBSYSTEM  OK:  The  Programs’  subsystem  command 
"Attach"  makes  the  SUBSYSTEM  you  specify  available  to  you.  Before  you  can 
attach,  the  program  must  be  loaded.  Attaching  is  done  automatically  when  you 
load  a  program  formatted  to  run  as  a  subsystem.  See  loading  (PROGRAMS), 
Detach,  Append. 

subsystems  already  loaded  but  not  usually  attached:  See  Attachable. 

TNLS  example: 

PROG  C:  Attach  C:  Subsystem  C:  Calculator  OK: 

PROG  C: 

Attachable  subsystems  already  loaded:  Use  the  programs  subsystem 
command  "Attach  Subsystem"  to  make  one  of  these  subsystems  available  if  it  is 
not  already.  If  you  want  a  userprogram  or  subsystem  always  automatically 
available  to  you  when  you  enter  NLS,  use  the  Useroptions  subsystem  command 
"Include". 

Supervisor:  See  Universal. 

Syntax  (generator):  This  subsystem  allows  you  to  generate  lists  of  NLS  command  syntax.  Use 
programs  subsystem’s  Attach  command  to  make  it  available.  See  also:  Attach,  Syntax. 

Base:  5«*Base. 

Sendmail:  SeeSendmail. 

Useroptions:  See  Useroptions. 

Calculator:  See  Calculator. 

Programs:  See  Programs. 
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XXX:  (for  Wheels  and  Operators  only,  not  documented  here)  Seexxx. 

Augmentation:  a  term  to  describe  extension,  improvement,  or  amplification  of 
human  intellectual  and  organizational  capabilities  by  means  of  close  interaction 
with  computer  aids  and  by  use  of  special  procedural  and  organization  techniques 
designed  to  support  and  exploit  this  interaction.  For  Augmentation  Reserach 
Center.  See  also:  ARC. 

Author:  The  Author  of  a  document  or  message  distributed  via  the  sendmail 

subsystem  is  usually  specified  by  the  IDENT  of  the  person  logged  in  to  distribute 
the  mail.  If  you  use  "Interrogate”  the  author  will  be  you  unless  you  specify 
otherwise.  Other  IDENTs  can  be  substituted  or  added  with  Sendmaifs  Authors 
command.  After  you  have  mailed  an  item  that  you  authored,  a  citation  to  it  will 
appear  in  your  INITIAL  file  under  a  branch  with  the  STATEMENTNAME 
author.  This  is  your  automatic  bibliography  of  all  the  items  you  "published"  in 
the  Journal  via  the  Sendmail  subsystem. 

Sendmaifs  authors  command:  See  authors  (SENDMAIL). 

Authors  CONTENT  OK:  The  sendmail  subsystem  command  "Authors"  lets  you 
name  the  author(s)  of  a  Sendmail  item.  If  you  don’t  use  this  command,  the  ident 
under  which  you  are  logged  in  will  be  the  author.  Specify  the  IDENTs  of  the 
author(s)  of  the  item  for  CONTENT. 

Sendmaifs  authors  command:  See  authors  (SENDMAIL). 
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b  Viewspec:  show  one  level  more:  "Show  one  more  level  than  previously 
specified."  This  code  is  often  combined  with  codes  x,  d,  and  e;  each  b  in  the 
string  adds  one  more  level.  Each  Viewspec  b  cancels  out  one  Viewspec  a. 

B  Viewspec:  level  indenting  off:  "Don’t  indent  the  levels;  print  all  statements  at 
left  margin."  This  turns  off  viewspec  A  or  Q,  See  also:  Level,  Capital -A, 
Capital-B. 

B-COlon:  B:  BUG:  5eeBug. 

back:  the  statement  immediately  preceding  the  statement  where  you  are  regardless 
of  level  or  of  source.  In  the  illustration,  lb3  is  back  from  statement  2.  Next  is 
the  opposite  of  back.  Typing  the  Uparrow  (t)  key  will  print  the  statement  that  is 
back  from  where  you  are.  See  also:  illustration. 

backarrow:  — :  In  TNLS  backarrow  —  usually  appears  when  <CTRL-W>  has 
been  hit  to  indicate  backspaced  word  (BW).  See  also:  help,  BC. 

backend:  part  of  a  software  system  that  performs  functions  you  specify  during 
your  interactions  with  a  frontend  system. 

backslash:  \:  prints  the  statement  you  are  in:  Typing  the  key  \  prints  the  entire 
statement  you  are  in..  You  may  place  the  backslash  among  the  elements  in  an 
ADDRESS.  After  you  terminate  the  ADDRESS,  you  will  see  printed  the  entire 
statement  pointed  to  by  the  element  preceeding  the  backslash  in  the  address.  In 
TNLS  at  the  herald  of  a  subsystem,  the  entire  statement  you  are  in  prints 
immediately  when  backslash  is  typed.  COMPARE  address,  slash,  period. 

TNLS  example: 

BASE  C:  \ 

2d  Dolphins  are  very  intelligent  mammals. 

BASE  C: 

Backspace  (in  commands):  erases  parts  of  your  command.  You  can  backspace 
single  characters  and  words  you  have  typed  in,  and  you  can  backspace  previous 
commandwords  and  operands.  Backspace  all  of  the  command  with  CD.  You 
cannot  backspace  the  effect  of  an  editing  command  after  it  has  been  executed 
except  by  deleting  all  of  the  modifications  since  your  last  update.  (You  can  copy 
things  from  an  old  version  of  a  file  if  it  still  has  what  you  want.)  Define  your 
own  backspace  control  characters  with  the  Control  command  in  the  Useroptions 
subsystem.  See  also:  control  (USEROPTIONS),  resetting. 

character:  Backspace  Character:  (BC)  See  Character. 
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word:  Backspace  Word:  (BW)  See  Word. 

Commands:  backspacing  at  a  prompt.  See  Commands. 

BASE  subsystem:  The  BASE  subsystem  is  the  major  subsystem  of  NLS.  It  has 
commands  that  allow  you  to  name,  read,  and  write  information  online  and  output 
it  to  hardcopy.  When  you  enter  NLS,  you  begin  in  the  BASE  subsystem. 

How  to  use  the  BASE  subsystem:  See  how. 

commands  in  the  BASE  subsystem:  See  also:  Command,  HOW,  SUBSYSTEM, 
systems-commands:  See  Universal. 

Insert:  add,  duplicate,  create  information.  See  Insert. 

Show:  see  the  status  of  special  things.  See  Show. 

Set:  See  Set. 

Reset:  See  Reset. 

modifying-commands:  Replace,  Copy,  Transpose,  etc.  See  modifying-commands. 

viewing-commands:  jumping,  printing,  reading,  etc.  See  Viewing-commands. 

file-handling:  See  file-handling. 

archiving-commands:  See  archiving-commands. 

terminal-commands:  See  terminal-commands. 

display-commands  only:  See  display-commands. 

recording,  marking  characters:  See  recording. 

BBN:  Bolt  Beranek  and  Newman  Inc.  50  Moulton  St.,  Cambridge,  Mass.  021388 
A  commercial  research  and  development  organization  under  contract  to  ARPA 
for  services  to  the  ARPA  Network,  and  under  other  contracts  that  lead  to 
frequent  interaction  with  ARC.  BBN  is  responsible  for  the  development  of 
TENEX. 

BC:  Backspace  Character:  See  Character. 

Bells:  If  the  system  rings  the  bell  on  your  terminal  (or  prints  "ding-a-ling"  on 
terminals  that  lack  bells)  either  someone  is  trying  to  connect  (or  link)  to  you,  or 
you  have  asked  the  system  to  complete  a  command  before  giving  it  enough 
information,  or  you  have  mistyped  a  command  character.  Usually  you  can  go  on 
by  typing  the  next  logical  character,  or  <CTRL-A>  and  the  next  character.  See 
also:  connect. 

binding: 

hardcopy  binding:  ask  FEEDBACK  for  information  specific  to  you  about  binding  documents. 

Binding  Precedence:  Order  of  Operator  Execution:  The  order  of  performing  individual 
operations  within  an  equation  is  determined  by  the  heirarchy  of  operator  execution  (or  binding 
precedence)  and  the  use  of  parentheses.  Operations  of  the  same  heirarchy  are  performed  from 
left  to  right  in  an  expression.  Operations  in  parentheses  are  performed  before  operations  not  in 
parentheses.  The  order  of  execution  of  operators  (from  first  to  last)  is  as  follows: 

unary  -,  unary  +:  minus  or  plus  sign  in  front  of  a  number  not  addition  or  subtraction. 

.A  Arithmetic  AND:  a  .  A  b  =  bit  pattern  which  has  ones  wherever  both  a  and  b  had 
ones,  and  zero  elsewhere. 
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•  V,  .  X  Arithmetic  OR:  a  .  V  b  =  bit  pattern  which  has  l’s  wherever  either  an  a  or  b 
had  a  1  and  0  elsewhere. 

a  .  X  b  =  bit  pattern  which  has  l’s  wherever  either  an  a  had  a  1  and  b  had  a  0,  or  a  had 
a  0  and  b  had  a  1,  and  0  elsewhere. 

*,  /,  MOD  (multiplication,  dvision,  remainder):  *  =  multiplication 
a  MOD  b  gives  the  remainder  of  a  /  b. 

+,  — :  addition,  subtraction. 

relational  tests  (e  g.,  >  =  ,  <  =  ,  >,  <,  =,  #,  IN,  OUT) 

NOT  Relational  tests  (e  g.,  NOT  > ) 

NOT. 

AND 

OR. 

BLAP  \blap\n  [  bla-bla-bla  ]  la:  appropriate  data,  b:  information  specified 
by  context,  c:  redundant  data  not  worth  verbalizing  in  this  context.  2:  bullshit. 

Bootstrapping:  A  name  for  the  research  strategy  of  the  ARC.  By 

"bootstrapping"  we  mean  taking  advantage  of  the  feedback  in  recursive 
development  of  systems.  That  is,  we  try  to  test  ways  of  augmenting  intelligence 
by  their  usefulness  in  developing  new  systems  to  augment  intelligence,  through  the 
use  of  the  new  system  features  by  (mainly)  the  developers  of  the  system. 

bracket: 

Angle  brackets:  See  anglebrackets. 

Square  brackets  in  Content-analyzer  Patterns:  See  Square- brackets. 

Branch:  a  statement  plus  all  its  substatements  with  all  of  their  substatements,  and 
so  on  to  the  end.  In  the  illustration,  the  branch  defined  (and  addressed)  by 
statement  1  consists  of  1,  la,  lb,  1  b  1 ,  lb2,  lb3;  branch  3c  consists  of  3c,  3c  1, 
3c la;  branch  2  consists  of  statement  2.  Branch  0,  (the  branch  defined  by  the 
origin  statement)  in  any  file,  consists  of  the  entire  file. 

end:  See  End,  Statement. 

illustration  of  file  structure:  See  Illustration. 

Branch  (at)  SOURCE  OK:  The  Sendmail  subsystem  command  "Branch"  allows 
you  to  send  an  NLS  branch.  Specify  the  Branch  to  be  mailed  as  the  SOURCE. 
VIEWSPECS  do  not  matter. 

BRANCHNAME:  Istatementname  (preceded  by  exclamation  !):  an  address  element 
that  restricts  the  search  for  a  statementname  to  the  branch  whose  source  is  the 
statement  where  you  are  (the  location  pointed  to  by  the  previous  element  in  a 
multiple  element  address).  The  statementname  of  the  source  of  your  branch  is  the 
first  statement  tested  in  the  search.  You  are  placed  at  the  first  character  of  the 
appropriately  named  statement.  For  example,  typing:  pigs  Ichauvinist  would  take 
you  to  the  statement  named  chauvinist  in  the  branch  named  pigs. 

Break  Statement  (at)  DESTINATION  LEVEL— ADJUST  OK:  The  command 
"Break"  divides  one  statement  into  two  statements.  It  will  break  immediately 
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after  the  next  visible  following  the  DESTINATION  you  point  to.  You  may 
specify  the  level  of  the  second  statement  relative  to  the  first  one. 

TNLS  example: 

BASE  C:  Break  C:  Statement  at  A.  jackal 

L:  d 

BASE  C: 

Effects:  The  second  statement  will  begin  with  the  next  visible  following  the  one  you  specified  in 
the  command.  The  invisible  which  was  between  the  two  visibles  will  disappear.  If  you  want 
the  second  statement  to  be  at  the  same  level  as  the  first  statement,  just  give  a  Command 
Accept  for  LEVEL-ADJUST.  After  execution  you  are  at  the  first  character  of  the  second 
statement. 

buffers:  the  computer  memory  space  available  for  you  to  add  programs.  Loading 
a  program  that  requires  more  program  buffer  space  than  you  have,  should 
automatically  increase  your  program  buffer  space  but  will  not  delete  it  when  you 
delete  the  program.  You  can  see  how  much  program  space  you  are  currently 
using  with  the  Programs’  Show  Status  command.  You  can  control  it  using 
Programs’  Set  Buffer  (space)  command.  Your  user  programs  share  buffer  space 
with  files  you  are  using.  Increasing  the  size  of  your  program  buffer  space 
decreases  the  amount  of  space  available  for  your  files  with  a  possible  slowdown  in 
response.  100  pages  are  available  total. 

Programs’  Show  Status  command:  5ceShow  (PROGRAMS). 

Programs’  Set  Buffer  size  command:  5eeSet  Buffer  (PROGRAMS). 

Programs’  Reset  Buffer  size  command:  See  Reset  (PROGRAMS). 

bug: 

Report  something  that  does  not  work  as  documented.  See  reporting. 

A  DNLS  addressing  feature  (prompted  by  B). 

BUG:  To  BUG  in  DNLS:  To  bug  (prompted  by  B  in  DNLS)  means  to  point  to 
something  on  your  screen.  To  BUG  something,  hold  down  on  the  rightmost 
button  of  the  mouse  until  the  traveling  mark  on  the  screen  (the  cursor)  is 
positioned  under  the  place  you  wish  to  point  to.  Then  let  up  on  the  button.  A 
bugmark  (such  as  a  blot-out,  circle,  underline,  or  inversion  of  a  character  on  your 
screen)  will  indicate  which  character  has  been  marked.  The  cursor  is  the 
traveling  mark  on  the  DNLS  screen  which  you  control  with  the  hand-held  mouse. 
See  also:  MOUSE. 

buttons:  See  Mouse. 

BW:  Backspace  Word:  See  Word. 
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C  ViewspeC:  show  all  levels:  "Show  all  levels."  Example:  if  you  were  previously 
looking  at  all  lines  of  2  levels  only,  viewspecs  string  ct  would  show  you  one  line 
of  all  levels.  This  code  releases  any  previous  level  truncation. 

C  ViewspeC:  show  statement  names:  "Show  statement  names."  Statement  names 
are  shown  enclosed  in  name  delimiters  at  the  beginning  of  named  statements. 
Viewspec  D  turns  off  statement  names.  This  is  a  default  viewspec.  See  also: 
Statementname,  Capital-D. 

C  — colon:  C:  Commandword:  a  prompt  in  NLS  that  asks  for  a  command  word.  If 
prompting  is  on,  you  will  see  a  "C:  ".  Command  words,  normally  a  verb  or  a 
noun,  tell  NLS  what  to  do.  If  the  system  prints  a  questionmark  (in  DNLS),  or 
you  hear  a  bell  (in  TNLS),  you  have  typed  a  character  that  is  not  part  of  a 
command  word  that  is  possible  at  that  point.  See  also:  verb-nominal,  prompts. 

CA:  Command  Accept:  The  key  you  type  to  carry  out  a  command  and  make  NLS 
ready  for  the  next  command  to  be  specified.  This  is  the  key  most  often  used 
when  prompted  by  "OK:  ".  The  control  character  for  CA  is  <CTRL-D>  and 
by  default  in  TNLS  <CR>  (carriage  return)  acts  as  CA.  The  right-most  button 
on  the  mouse  also  specifies  command  accept.  See  also:  OKINSERT. 

OKREPEAT,  CD. 

Making  some  other  key  work  like  <CTRL-D>:  See  control  (USEROPTIONS). 

CA  is  also  used  for  content-analyzer  filename  extensions:  See  CA  (PROGRAMS). 

CA  — colon:  CA:  Command  Accept  <CTRL-D>:  See  CA. 

•  CA;  content-analyzer  Program:  A  filename  with  this  extension  points  to  a 
compiled  L10  content-analyzer  program.  The  Load  Program  command  in  the 
Programs  subsystem  will  place  it  in  your  buffer  and  automatically  institute  it  as 
your  content-analyzer  replacing  any  other  that  might  be  there.  See 
Content-analyzer. 

Calculator  subsystem:  allows  you  to  do  arithmetic  in  a  way  integrated  with  the 
rest  of  NLS.  Say  Goto  Calculator  and  type  a  number  (NUM)  followed  by  OK 
and  then  an  arithmetic  operator  (Add,  -f ,  Subtract,  -,  etc.)  followed  by  a  number. 
Terminate  numbers  with  an  OK.  If  you  have  a  column  of  numbers  in  a  file,  you 
can  add  the  column  by  pointing  to  the  numbers.  You  can  Insert  or  Replace  the 
result  in  any  NLS  file.  The  Format  command  specifies  how  the  result  will 
appear.  All  work  is  held  in  a  special  Calculator  file  created  for  you.  You  may 
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keep  several  running  totals  in  up  to  ten  accumulators  and  enter  simple  arithmetic 
expressions  as  if  they  were  numbers. 

file:  Calculator  file:  See  File, 
arithmetic  operations:  See  Arithmetic, 
commands  in  the  Calculator: 

Add  CONTENT  OK:  See  Add  (CALCULATOR). 

Clear:  See  Clear  (CALCULATOR). 

Divide  CONTENT  OK:  See  Divide  (CALCULATOR). 

Execute  (command  in)  SUBSYSTEM:  See  Execute. 

Evaluate  CONTENT  OPERATOR  OK:  See  Evaluate  (CALCULATOR). 

Format:  See  Format  (CALCULATOR). 

Goto  (subsystem)  SUBSYSTEM  OK:  See  Goto. 

Insert  (accum  following)  STRING/STRUCTURE:  See  Insert  (CALCULATOR). 
Multiply  CONTENT  OK:  See  Multiply  (CALCULATOR). 

NUM:  See  NUM  (CALCULATOR). 

OKREPEAT  <CTRL-B>:  See OKREPEAT. 

Quit:  See  quit. 

Replace  STRING/STRUCTURE  (at)  DESTINATION  (by  accumulator)  OK:  See 
Replace  (CALCULATOR). 

Show:  See  Show  (CALCULATOR). 

Subtract  CONTENT  OK:  See  Subtract  (CALCULATOR). 

Total  OK:  See  Total  (CALCULATOR). 

Use:  See  Use  (CALCULATOR). 

Write  (new)  File  CONTENT  OK:  See  Write  (CALCULATOR). 

X:  x  command:  See  Multiply, 
star  command:  *:  See  Multiply, 
plus  command:  +  :  SeeAdd. 
minus  command:  See  Subtract, 

slash  command:  /:  See  Divide, 
semicolon  command:  See  Semicolon. 

Capital  — A  viewspec:  level  indenting  on:  "Indent  each  level  more  than  the  last 
level."  The  number  of  spaces  each  level  is  indented  is  usually  3,  but  you  can 
specify  it  with  the  Useroptions  command  Printoptions  Indenting.  This  viewspec 
changes  viewspec  B  and  Q.  This  is  a  default  viewspec.  See  also:  Level, 
Capital-B,  Capital-Q,  Printoptions  (USEROPTIONS). 

Capital- B  viewspec:  level  indenting  off:  "Don’t  indent  the  levels;  print  all 
statements  at  left  margin."  This  turns  off  viewspec  A  or  O.  See  also:  Level, 
Capital- A,  B  Viewspec. 

Capital  — C  viewspec:  show  statement  names:  "Show  statement  names." 

Statement  names  are  shown  enclosed  in  name  delimiters  at  the  beginning  of 
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named  statements.  Viewspec  D  turns  off  statement  names.  This  is  a  default 
viewspec.  See  also:  Statementname,  Capital-D. 

Capital  — D  viewspec:  don’t  show  statement  names:  "Don’t  show  statement 
names."  If  the  first  word  of  any  statement  is  enclosed  in  the  name  delimiters 
defined  for  that  statement,  it  will  not  be  shown  when  the  statement  is  output  or 
viewed.  To  show  statement  names,  use  Viewspec  C.  See  also:  Statementname, 
Capital-C. 

Capital  — E  viewspec:  paginate  when  printing  (TNLS  only):  "Paginate  when 
printing."  TNLS  will  format  your  text  into  pages--numbered,  separated  by  a 
cutting  line  consisting  of  — ’s,  and  with  margins-when  printing  at  the  terminal  via 
any  Print  command.  This  is  a  default  viewspec.  See  also:  Capital  —  F . 

Capital  — F  viewspec:  TNLS:  no  paging/DNLS:  recreate  display:  TNLS  output 
by  Print  commands  at  your  terminal  will  not  be  separated  by  pages.  To  turn 
pagination  on,  use  Viewspec  E.  See  also:  Paginate,  Print,  Capital — E .  In  DNLS 
use  capital-F  to  be  sure  your  screen  recreates.  See  also:  U 

Capital  — G  viewspec:  statement  numbers/SIDs  right:  "Place  statement 

identification  at  the  right  margin."  If  viewspec  m  is  on,  and  you  turn  G  on, 
whichever  type  of  identification  is  currently  on  (viewspec  I-SIDs  or  J-statement 
numbers)  will  appear  at  the  right  margin  after  each  statement.  Viewspec  H  turns 
G  off  and  shows  identification  at  the  left  of  statements.  Example:  the  string 
mGJ  will  show  statement  numbers  at  the  right  margin.  See  also: 

Statementnumber,  SIDs,  m,  Capital-1,  Capital- J,  Capital-H. 

Capital  — H  viewspec:  statement  numbers/SIDs  left:  "Place  statement 

identification  at  the  left  of  each  statement."  This  viewspec  takes  effect  when 
viewspec  m  is  on.  Whichever  type  of  identification  is  currently  on  (I--SIDs  or 
J--statement  numbers)  will  appear  at  the  beginning  of  each  statement.  Example: 
if  you  have  SIDs  on  at  the  right  and  want  to  change  to  statement  numbers  at  the 
left,  use  the  string  HJ.  This  is  a  default  viewspec.  See  also:  Statementnumber, 
SIDs,  m,  Capital-1,  Capital  — J,  Capital-G. 

Capital  — I  viewspec:  show  SIDs,  not  statement  numbers:  "Use  SIDs  for  statement 
identification."  If  viewspec  m  is  on,  turning  I  on  will  show  each  statement’s  SID. 
Viewspec  J  shows  statement  numbers  instead.  The  viewspecs  G  (right  margin) 
and  H  (left  of  statement)  determine  where  the  statement  numbers  will  appear. 
Example:  the  string  mIG  will  make  SIDs  appear  at  the  right  margin  after  each 
statement.  See  also:  Statementnumber,  SID,  m,  Capital- J,  Capital-H,  Capital-G. 

Capital -J  viewspec:  show  statement  numbers,  not  SIDs:  "Use  statement 
numbers  for  statement  identification."  This  viewspec  takes  effect  when  viewspec 
m  is  on.  It  is  also  used  to  change  I  (show  SIDs).  The  viewspecs  G  (right 
margin)  and  H  (left  of  statement)  determine  where  the  statement  numbers  will 
appear.  Example:  if  you  have  SIDs  on  at  the  right  and  want  to  change  to 
statement  numbers  at  the  left,  use  the  string  HJ.  This  is  a  default  viewspec.  See 
also:  Statementnumber,  SID,  m,  Capital-1,  Capital-H,  Capital-G. 

Capital -K  viewspec:  statement  signatures  on:  "Show  statement  signatures  after 
each  statement."  Viewspec  L  suppresses  statement  signatures;  K  switches  them 
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on.  Statement  signatures  contain  the  ident  of  the  person  who  last  edited  that 
statement  and  the  date  and  time  of  the  last  edit.  See  also:  IDENT,  Ca  pita  I  —  L . 

Capital  — L  viewspec:  statement  signatures  off:  "Don't  show  statement 

signatures."  L  switches  off  K  (show  statement  signatures).  This  is  a  default 
viewspec.  See  also:  Statement,  Signatures,  Capital-K. 

Capital  — 0  viewspec:  user  sequence  generator  on:  "Turn  on  user-written  sequence 
generator."  Viewspec  P  employs  the  system’s  standard  sequence  generator  in 
lining  up  statements  for  output.  It  is  possible  (but  only  knowing  advanced  L10 
programming)  to  write  your  own  sequence  generator  program.  Viewspec  O,  if 
turned  on,  would  then  use  yours  instead  of  the  standard  one.  See  also: 

Sequence,  Capital-P. 

Capital  —  P  viewspec:  user  sequence  generator  off:  "Do  not  use  user-written 
sequence  generator  program."  This  viewspec  returns  control  to  the  system’s 
standard  sequence  generator  in  lining  up  statements  for  output.  Viewspec  O 
switches  to  a  user-written  sequence  generator  program  (writing  one  requires 
knowing  advanced  L10  programming).  This  is  a  default  viewspec.  See  also: 
sequence,  Capital-O. 

carriagereturn:  See  cr. 

CASEMODE:  Upper,  Lower,  or  First  (letter  upper):  "Upper"  sets  all  alphabetic 
characters  to  upper  case.  "Lower"  sets  all  alphabetic  characters  to  lower  case. 
"First  (letter  upper)"  sets  the  first  alphabetic  character  only  of  all  words  to 
uppercase.  [Side-effect:  if  you  Force  Text  in  first  letter  upper  and  the  text  starts 
in  the  middle  of  a  word,  the  first  character  of  the  text  (in  the  word  it  begins  in) 
will  be  capitalized.]  See  also:  Word . 

catalogs  and  indexes:  online  and  offline  sources  for  finding  items  recorded  in 
the  NLS  journal  and  XDOC  collections.  There  are  three  kinds  of  Journal 
indexes.  Author,  Number,  and  Title-word.  Jump  (to)  Link  <  userguides,  locator, 

>  to  access  the  indexes. 

categories  Of  command  lists:  The  BASE  subsystem  is  the  subsystem  in  which 
you  are  placed  when  you  enter  NLS  and  which  has  many  capabilities  such  as  File 
handling,  viewing,  and  printing.  Universal  commands  are  commands  available  in 
most  subsystems.  Any  of  the  other  subsystems  listed  below  are  available  via  the 
Goto  Subsystem  command  in  all  subsystems.  See  also:  SUBSYSTEM. 

Universal  (supervisor)  subsystem:  See  Universal. 

Base:  See  Commands  (BASE). 

Help:  See  Commands. 

questionmark  (?):  See  Questionmark. 

Identification:  See  identification. 

Sendmail:  See  Commands  (SENDMAIL). 

insert  journal  submission  form  (Base  command):  See  insert  sendmailform. 

Programs:  See  Commands  (PROGRAMS). 

Useroptions:  See  useroptions. 
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Calculator:  See  calculator. 

CD:  Command  Delete:  The  key  you  type  to  abort  a  command  at  any  time  before 
the  final  confirm.  Typing  CD  leaves  you  ready  to  specify  another  command.  The 
control  character  for  CD  is  <  CTRL-X  >  ,  and  by  default  in  TNLS  <  DEL  >  acts  as 
CD.  The  middle  button  on  the  mouse  also  specifies  command  delete.  You  can 
make  another  character  stand  for  CD  by  using  the  Control  Character  command 
in  the  Useroptions  subsystem.  See  also:  Backspace,  Ctrl-character,  Resetting. 

centerdot:  changed  to  OKREPEAT:  See  OKREPEAT. 

changing:  ways  of  changing  viewspecs:  altering  how  a  file  will  be  presented.  You 
can  change  the  viewspec  codes  in  effect  in  the  following  ways:  using  the  BASE 
subsystem's  Set  Viewspecs  command  to  enter  new  codes  (which  change  previous 
ones),  entering  codes  while  holding  down  the  two  rightmost  buttons  on  the  mouse 
in  DNLS,  using  the  BASE  Reset  Viewspecs  command  which  sets  them  back  to 
your  default,  and  by  entering  codes  in  some  NLS  commands,  namely  when 
prompted  with  "V:".  When  you  enter  viewspecs,  they  remain  in  effect  until  you 
change  them  again. 

The  BASE  Set  Viewspecs  command:  5eeSet  Viewspecs. 

The  BASE  Reset  Viewspecs:  See  Reset  Viewspecs. 

The  BASE  Show  Viewspecs  (status)  command:  5eeShow  Viewspecs  (BASE). 

The  USEROPTIONS  Viewspecs  Default  command:  See  Viewspecs  (USEROPTIONS). 

The  USEROPTIONS  Show  Viewspecs  command:  5«*Show  Viewspecs  (USEROPTIONS). 

Character:  single  elements  that  can  be  visible  or  invisible  such  as  letters,  numbers, 
punctuation  marks,  spaces,  carriage  returns  and  control  characters.  Each 
character  is  represented  in  the  TENEX/PDP-10  system  by  at  least  7  bits. 

non-printing  characters  (invisible):  See  Invisible. 

printing  characters  (visible):  See  Printing. 

numbers:  See  Number. 

CTRL-character:  <  CTRL-  > :  See  CTRL-character. 

<UKC>:  Unknown  Character:  SeeUKC. 

character:  Backspace  Character:  BC:  The  key  you  type  to  erase  the  last 

character  you  typed.  In  TNLS,  BC  or  <CTRL-A>  will  echo  both  a  slash  and 
the  character  it  has  deleted.  You  may  backspace  as  many  times  as  you  like.  In 
DNLS,  the  BC  key  on  the  keyboard,  the  left  mouse  button  and,  <CTRL-A>  all 
specify  backspace  character.  In  DNLS,  the  backspaced  character(s)  will  simply 
disappear.  When  you  use  BC  in  a  commandword  specification,  it  will  erase  the 
whole  word.  See  also:  Ctrl-character,  Backspace. 

CHARACTERADDRESS:  (’CHARACTER  preceded  by  single  quote):  where 
CHARACTER  =  a  single  character  :  an  address  element  that  moves  you  to  the 
next  occurrence  of  that  character.  If  the  character  is  not  found  in  the  current 
statement,  the  search  will  go  on  to  the  next  statement  in  the  hierarchy,  and  so  on 
to  the  end  of  the  file.  After  you  use  a  CHARACTERADDRESS,  if  you  want  to 
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jump  to  a  subsequent  occurrence  of  that  character,  use  the  TAB  command.  See 
it  I  so:  Character,  Statement,  Hierarchy,  TAB-command. 

Specialeffects:  CHARACTERADDRESS  may  be  followed  by  the  equal  sign  and  a  number  and 

a  "c" 

e.g.:  ’a  =  2c  indicating  the  second  occurrence  of  the  letter  a. 

This  may  be  further  followed  by  another  equal  sign  and  a  number  and  a  "s"  meaning  to  search 
only  within  that  number  of  statements.  A  "w"  can  be  used  instead  of  a  "c"  to  mean  the  Nth 
occurrence  of  CEIARACTER  as  a  word.  (If  a  number  is  not  specified  it  will  be  taken  to  be  1) 
EXAMPLE:  To  search  for  the  word  "a"  within  the  next  2  statements  only,  type:  ’a  =  w  =  2s. 


citation:  See  initial. 

class  —  I:  See  Userprograms. 

Class-ll  and  III  user-programs:  in  Directory  XPROGRAMS:  ARC  places 
user-programs  into  class  I,  II,  and  III.  Help  descriptions  are  provided  only  for 
class  I  which  contains  user-programs  approved  by  both  of  the  ARC  assistant 
directors  and  the  ARC  user  development  coordinator.  These  are  maintained  by 
ARC  across  system  changes.  Class  II  contains  user-programs  not  officially 
maintained  by  ARC  but  which  use  procedures  guaranteed  by  ARC  not  to  change. 
For  a  list  of  these  procedures,  see  procedures.  Class  III  contains  user-programs 
with  no  guarantee  by  ARC  to  run  across  system  changes.  A  list  of  some  class  II 
and  III  user-programs  made  available  by  their  authors  resides  in  directory 
"xprograms".  Jump  to  Link  <xprograms,  library,  >.  Unlike  Class-I  programs, 
you  must  place  the  directory  name  "xprograms,  "  in  front  of  a  Class-II  and  III 
program  name  in  order  to  load  it. 

Clear  (TTY  Window)  OK:  This  DNLS  command  clears  your  TTY-simulation 
window.  See  also:  TTY-simulation. 

Clear:  Use  the  Calculator  subsystem  command  "Clear"  to  erase  your  calculator 
file  or  set  your  current  accumulator  to  zero.  See  also:  file  (CALCULATOR), 
accumulator. 

Accumulator:  Clear  Accumulator  OK:  Use  the  Calculator  subsystem  command  "Clear 

Accumulator"  to  set  your  current  accumulator  to  zero.  See  also:  Accumulator,  Use. 

File:  Clear  File  OK:  Use  the  Calculator  subsystem  command  "Clear  File"  to  erase  your 

calculator  file.  See  also:  File  (CALCULATOR). 


clipping  viewspecs:  cut  off  lines  or  levels: 
Lines:  t,  r,  q,  s,  w,  x. 

d  Viewspec:  show  first  level  only.  Seed. 

e  Viewspec:  level  of  referenced  statement.  Seee. 

b  Viewspec:  show  one  level  more.  Seeb. 

a  Viewspec:  show  one  level  less.  See  a. 

C  Viewspec:  show  all  levels.  See  c. 

t  Viewspec:  show  first  lines  only.  Seet. 

r  Viewspec:  snow  one  line  more.  Seer. 

q  Viewspec:  show  one  line  less.  Seeq. 

S  Viewspec:  show  all  lines.  Sees. 


Levels:  d,  b,  a,  c,  w,  x,  e 
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X  ViewspeC:  show  one  line  and  one  level  only.  See*. 
W  ViewspeC:  show  all  lines  and  all  levels.  Seew. 


CM:  Control  Marker:  A  Control  Marker  (CM)  is  always  pointing  to  a  character 
within  a  statement  in  a  file.  When  you  load  a  file,  the  CM  moves  to  the  first 
character  position  in  the  origin  statement.  Whenever  you  point  in  a  command, 
the  CM  moves,  usually  in  relation  to  your  current  location.  See  also:  Pointing, 
Character,  Statement,  File,  Load,  Origin,  Locating.  In  DNLS,  you  can  move 
the  CM  around  by  BUGGING  with  the  mouse.  See:  Viewing,  BUG. 

CML:  Command  Meta  Language:  a  formal  language  developed  at  ARC  for 

describing  the  command  language  and  interaction  of  a  subsystem  (or  an 
application  program)  with  its  human  user.  A  program  written  in  CML  is 
compiled  by  the  CML  compiler  and  the  data  structure  produced  is  called  a 
grammar.  A  filename  with  extension  .  CML;  points  to  a  compiled  subsystem 
grammar.  The  Load  Program  command  will  make  the  subsystem  available.  In 
order  to  load  simultaneously  the  CML  front  end  and  the  L10  supporting 
programs,  the  L10  program  file  must  have  the  same  name  but  with  extension 
.SUBSYS;  .  The  current  CML  userguide  is  <  Journal  document-19149,  >. 

interpreter:  CML  interpreter:  See  Interpreter. 

code:  See  Software, 
collaboration:  See  Dialog. 

COM:  an  acronym  for  Computer  Output  to  Microfilm:  The  NLS  Output  Processor 
can  create  files  suitable  for  printing  via  COM.  The  film  may  be  used  to  make 
plates  for  printing.  COM  allows  various  graphic  arts  quality  type  faces,  type 
sizes,  proportional  spacing,  and  one-  to  four-column  justification.  Read  the 

Output  Processor  User’s  guide  through  <  userguides,  locator,  >  for  more 
information.  The  printed  version  of  the  guide  shows  examples  of  type  face,  etc. 

output  COM  command:  See  Output  COM. 

combinations  Of  numbers,  u’s  and  d’s:  A  string  of  lowercase  u’s  and  d’s, 
optionally  preceded  by  integers,  terminated  by  a  SPACE  or  CA;  the  difference 
between  the  number  of  u’s  and  d’s  is  taken  as  a  level  adjustment  value.  The  value 
locates  the  STRUCTURE  so  many  levels  "up"  or  "down"  relative  to  your 
present  location.  See  also :  Level,  Leveladjust  (USEROPTIONS),  Prompts, 
STRUCTURE,  Statement,  CA. 

Command  language  parameters:  NLS  has  a  rich  and  powerful  command 
language  divided  into  SUBSYSTEMS  for  moving  around  in  and  modifying 
information.  To  use  a  command,  you  must  get  NLS  to  recognize  Commandword 
operators  which  are  then  followed  by  operands.  To  understand  any  of  the  NLS 
command  descriptions,  you  must  understand  the  notation  conventions. 
Noisewords  and  prompts  help  describe  what  is  happening. 

notation  for  command  syntax:  See  Notation. 

SUBSYSTEM:  See  SUBSYSTEM. 

Commandword  operators:  See  Commandword . 
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Operands:  See  Operands, 
prompts:  See  prompts. 

(noiseword):  See  Noiseword . 

OK:  command  confirmation:  See  OK. 

Backspace  in  commands:  See  Backspace, 
categories  of  command  lists:  See  Categories. 

Command-Accept:  See  CA. 

Command-Delete:  See  CD. 

Commandnominal:  See  Nominals.  - 

Commands:  backspacing  at  a  prompt:  You  can  backspace  out  of  commandwords 
using  both  BC  <  CTRL- A  >  and  BW  <  CTRL-W  >  .  In  TNLS  this  shows  up  as  —  . 
It  takes  you  back  to  your  previous  command  parameter  and  prompts  that,  or  it 
will  show  up  as  /  to  represent  a  deleted  character.  When  you  type  BC  or  BW  at 
a  prompt,  you  will  be  backed  up  to  the  previous  prompt.  In  TNLS  this  is 
represented  by  —  and  repeating  a  prompt.  See  also:  BC,  BW. 

certain  command  fields  where  backspacing  doesn’t  work:  Using  BW  or  BC  to  back  up 
through  commandwords  and  operands  will  trip  up  in  commands  using  perform  loops.  If 
feedback  and  prompts  start  looking  mixed  up  while  you’re  backspacing  through  a  command, 
you  should  give  a  CD  and  start  the  command  over.  Examples  of  commands  that  trip  up  on 
Backspace  are  Substitute  and  the  option  loop  in  the  directory  commands. 

commands  in  most  NLS  subsystems:  See  Universal. 

commands  in  the  BASE  subsystem:  See  also:  Command,  HOW, 

SUBSYSTEM. 

systems-commands:  See  Universal. 

Insert:  add,  duplicate,  create  information.  See  Insert. 

Show:  see  the  status  of  special  things.  See  Show. 

Set:  5eeSet. 

Reset:  See  Reset. 

modifying -commands:  Replace,  Copy,  Transpose,  etc.  See  modifying-commands. 

viewing-commands:  jumping,  printing,  reading,  etc.  See  Viewing-commands. 

file-handling:  See  file-handling. 

archiving-commands:  See  archiving-commands. 

terminal-commands:  See  terminal-commands. 

display-commands  only:  See  display-commands. 

recording,  marking  characters:  See  recording. 

commands  in  the  Calculator:  See  Calculator  subsystem, 
commands  in  the  Sendmail  subsystem: 

Authors  CONTENT  OK:  5ee  Authors  (SENDMAIL). 

Branch  (at)  SOURCE  OK:  5ee  Branch  (SENDMAIL). 
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Comment  CONTENT  OK:  See  Comment  (SENDMAIL). 

Distribute  (for)  CATEGORY  (to)  CONTENT  OK:  See  Distribute  (SENDMAIL). 
Execute  (command  in)  SUBSYSTEM:  See  Execute. 

Expedite  OK:  See  Expedite  (SENDMAIL). 

File:  DESTINATION  OK:  See  File  (SENDMAIL). 

Forward  (item  number)  CONTENT  (for)  ACTION/INFO  (only):  See 
(SENDMAIL). 

Goto  SUBSYSTEM  OK:  See  goto. 

Group  (from)  SOURCE  OK:  See  Group  (SENDMAIL). 

Offline  (item — located  at)  CONTENT  OK:  See  Offline  (SENDMAIL). 
OKREPEAT  <CTRL-B>:  See  OKREPEAT. 

Initialize  (specifications)  OK:  See  Initialize  (SENDMAIL). 

Insert:  See  Insert  (SENDMAIL). 

Interrogate  OK:  See  Interrogate  (SENDMAIL). 

Keywords  CONTENT  OK:  5ee  Keywords  (SENDMAIL). 

Message  CONTENT  OK:  See  Message  (SENDMAIL). 

Number  Assign/Previously  :  See  Number  (SENDMAIL). 

Obsoletes  (item  number(s))  CONTENT  OK:  SeeObsoletes  (SENDMAIL). 

Plex  (at)  SOURCE  OK:  SeePlex  (SENDMAIL). 

Private  OK:  See  Private  (SENDMAIL). 

Process  (sendmail  form  at)  DESTINATION  OK:  See  Process  (SENDMAIL). 
Public:  See  Public  (SENDMAIL). 

Quit  OK:  See  quit. 

RFC  (number)  CONTENT  OK:  See  RFC  (SENDMAIL). 

Reserve:  See  Reserve  (SENDMAIL). 

Send  (the  mail)  OK:  See  Send  (SENDMAIL). 

Show  Status/Record:  See  Show  (SENDMAIL). 

Statement  (at)  CONTENT  OK:  See  Statement  (SENDMAIL). 

Subcollections  CONTENT  OK:  See  Subcollections  (SENDMAIL). 

Title  CONTENT  OK:  See  Title  (SENDMAIL). 

Unrecorded  ANSWER:  See  Unrecorded  (SENDMAIL). 

Update  (to  item  number(s))  CONTENT  OK:  See  Update  (SENDMAIL). 

commands  in  the  Useroptions  subsystem:  See  useroptions. 
commands  limited  to  DNLS:  See  display-commands, 
commands:  list  of  Base  file-handling  commands:  See  file-handling, 
commands:  See  directory-commands, 
commands:  See  modifying-commands, 
commands  for  viewing:  See  viewing-commands. 
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Commandword  operators:  Those  parts  of  a  command,  usually  a  verb  followed 
by  a  nominal,  which  you  specify  and  which  must  be  recognized  by  the  system 
according  to  your  recognition  mode.  Some  examples  are  "Insert  Character"  and 
"Delete  Branch."  Commandword  operators  are  followed  by  the  command 
operands.  A  commandword  is  prompted  by  C:  .  In  command  descriptions, 
command  words  are  capitalized  (not  all  caps).  You  must  understand  your 
recognition  mode  before  you  can  use  NLS.  See  also:  NOTATION,  Recognition, 
Verb-nominal. 

Limit  commandword  feedback  in  TNLS:  See  Limit. 

categories  of  commands:  See  categories. 

Comment  CONTENT  OK:  The  Sendmail  Subsystem  command  "Comments" 
allows  you  to  enter  a  comment  as  part  of  your  journal  item.  It  will  be  attached 
to  the  citation  you  send.  The  comment  appears  as  page  one  of  the  hardcopy  item 
and  is  the  last  thing  in  its  online  header.  You  can  also  enter  comments  for 
specific  IDENTs  as  described  in  the  Distribute  command. 

CONTENT:  See  content. 

Header:  See  header. 

citation:  See  citation. 

The  Send  command:  See  send , 

communication:  See  Sendmail  subsystem. 

Compile:  The  Programs'  subsystem  command  Compile  translates  programming 
instruction  language  using  the  compiler  you  specify.  In  most  cases,  it  only 
compiles  those  instructions  which  pass  the  viewspecs  you  currently  have  in  effect. 

Assembler:  Compile  Assembler  (file  at)  DESTINATION  (using)  CONTENT  (to  file) 

CONTENT  OK:  The  Programs  Subsystem  command  "Compile  Assembler"  allows  you  to 
create  a  compiled  file  at  a  new  file  address.  DESTINATION  wants  you  to  specify  an  NLS  file 
containing  the  code  to  be  assembled  by  the  assembler.  The  first  CONTENT  wants  the 
FILEADDRESS  of  the  assembler  and  the  second  CONTENT  wants  the  FILEADDRESS  of 
the  new  file. 

TNLS  example: 

PROG  C:  Compile  C:  Assembler  (at)  A:  1 

(using)  T:  FAIL 

(to  file)  T:  prog 

Assembler  in  Progress 

PROG  C: 

Effects:  A  file  will  be  created  with  the  FILENAME  you  give  it.  If  you  don’t  specify  the 
extension,  it  will  default  to  REL. 

Content:  Compile  Content  (pattern)  CONTENT  OK:  The  Programs  subsystem  command 
"Compile  Content  (pattern)"  allows  you  to  typein  or  point  to  a  content-analyzer  pattern.  It 
then  compiles  the  pattern  and  makes  it  your  current  content-analyzer.  After  you  specify  the 
content-analyzer  pattern,  its  effect  is  turned  off  and  on  using  the  viewspecs  i,  j,  and  k.  When 
pointing  to  a  pattern  instead  of  typing  it  in,  you  must  point  to  the  first  character  of  the  entire 
pattern  and  it  must  have  a  semicolon  following  it.  This  is  a  duplicate  of  the  BASE  subsystem 
command  "Set  Content  (pattern)  To".  Content-analyzer  programs  already  compiled  into  a 
program  file,  can  be  loaded  using  the  Programs  subsystem  command  "Load  Program". 
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content-analyzers:  See  content-analyzer, 
content-analysis  viewspecs:  See  content-analysis. 

The  Programs  subsystem  Load  Program  command:  See  load  (PROGRAMS). 

File:  Compile  File  (at)  DESTINATION  (using)  CONTENT  (to  file)  CONTENT  OK:  The 
Program’s  subsystem  command  "Compile  File  "  allows  you  to  create  a  compiled  file  at  a  new 
file  address.  DESTINATION  wants  you  to  specify  the  NLS  file  containing  the  code  to  be 
compiled.  The  first  CONTENT  wants  the  FILEADDRESS  of  the  compiler  and  the  second 
CONTENT  wants  the  FILEADDRESS  of  the  new  file. 

TNLS  example: 

PROG  C:  Compile  C:  File  (at)  A:  1 
(using)  T:  L10 
(to  file)  T:  prog 
PROG  C: 

Effects:  compiles  a  program  into  a  file  with  the  extension  REL  (unless  otherwise  specified). 
The  FILENAME  must  be  the  same  as  the  program  name.  L10  compilations  must  begin 
at  a  "FILE"  statement  and  will  stop  at  the  "FINISH"  statement.  The  compiled  file 
can  then  be  loaded  into  your  programs  buffer  by  the  Load  Program  command  in  the 
Programs  subsystem.  It  goes  away  when  you  delete  it  from  your  buffer  or  when  you  end 
your  session.  It  must  be  recompiled  the  next  time  you  want  to  run  it. 

REL  file:  See  RFL. 

Load  Program  command:  See  load  (PROGRAMS). 

L10:  Compile  L10  (user  program  at)  DESTINATION  OK:  The  Program’s  subsystem  command 
"Compile  L10"  compiles  an  L10  user  program  at  the  DESTINATION  you  specify  into  the 
user  program  buffer  and  enters  its  name  onto  the  stack.  It  does  not  create  a  file  for,  nor 
institute,  that  program.  See  also:  file,  institute. 

Effects:  L10  compilations  must  begin  at  a  "PROGRAM"  statement  and  will  stop  at  the 
"FINISH"  statement.  If  any  errors  are  found  in  the  program,  they  will  print  and  the 
program  will  not  compile.  After  the  program  has  been  compiled,  you  may  institute  or 
run  it. 

Institute  command:  See  institute. 

Run  command:  5eerun. 

TNLS  example: 

PROG  C:  L10 

PROG  C:  Compile  C:  L10  (user  program  at)  A:  1 
PROG  C: 

Procedure:  Compile  Procedure  (at)  DESTINATION  OK:  The  Program’s  subsystem  command 
"Compile  Procedure"  compiles  the  procedure  at  the  DESTINATION  you  specify  (using  the 
viewspecs  you  currently  have  in  effect)  and  replaces  the  procedure  with  the  same  name.  See 
also:  proc-rep. 

Compiler:  a  program  which  translates  a  programming  language.  Compilers  for  the 
following  languages  are  available  from  NLS. 

L 1  0:  See  LI 0 . 

CML:  See  CML. 

compiling  user  programs:  translating  user-readable  "source"  code  into 

machine-executable  instructions.  Once  a  program  has  been  written  as  an  NLS 
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file,  it  may  be  compiled,  either  directly  into  your  programs  buffer,  or  into  a  file 
which  may  be  subsequently  loaded  into  the  buffer.  The  Compile  command  in  the 
Programs  subsystem  allows  text  to  be  compiled  to  a  file,  to  the  buffer,  or  as  a 
content-analyzer. 

Assembling:  See  Assembling. 

complaints:  Report  your  difficulties  with  NLS  to  FEEDBACK,  and  someone  will 
listen  to  you  and  answer  you.  See  reporting. 

Computers:  See  site. 

CONCEPTS:  See  how. 
confirm:  See  ok. 

Connect  (to)  Directory/Display/TTY  : 

Directory:  Connect  (to)  Directory  CONTENT  (Password)  PASSWORD  OK:  The  command 
"Connect  to"  allows  you  to  use  most  NLS  and  TENEX  files  as  if  you  had  logged  in  under  the 
directory  you  specify.  If  you  already  have  access  to  the  directory  you  specify  for  CONTENT, 
you  can  just  hit  CA  instead  of  typing  the  PASSWORD.  See  also:  CONTENT,  PASSWORD, 
CA,  OPTION,  ADDRESS,  file,  directory.  Ask  your  computer’s  operator  about  directory 

groups. 

TNLS  example: 

BASE  C:  Connect  to  C:  Directory  T:  guest 

Password  T: 

BASE  C: 

Effects:  Modification  files,  which  contain  the  changes  you  have  made,  will  appear  in  the 
directory  where  you  logged  in  until  you  update  the  modified  file. 

Display:  [DNLS  only]  Connect  (to)  Display  (number)  CONTENT  (for)  Input/Output:  Output 
(only)  mode  does  not  allow  you  to  do  anything  except  watch.  Input  (and  output)  mode  is  for 
cooperative  work.  For  TENEX-type  linking,  use  the  Connect  to  TTY  command  for  Output 
(only).  See  Connect  TTY  Output. 

Output:  Connect  (to)  Display  (number)  CONTENT  (for)  Output  (only)  OK:  The  DNLS 
command  "Connect  (to)  Display  (number)"allows  you  to  watch  another  Display 
terminal.  That  terminal  must  issue  the  "Accept  Connection  (for)  Output  (only)" 
command  giving  your  TTY  number.  Use  instead  Input  (and  Output)  mode  for 
collaboration  with  a  shared  view  of  the  same  file.  See  also:  Connect  Display  Input, 
Connect  TTY  output.  Terminate  the  Connection  by  hitting  <CTRL-P>  twice. 

Input:  Connect  (to)  Display  (number)  CONTENT  (for)  Input  (and  Output)  OK:  The 
DNLS  command  "Connect  (to)  Display  (number)"  allows  you  to  collaborate  with 
another  person  by  viewing  the  same  image  of  a  file  after  issuing  this  command.  The 
person  at  the  terminal  with  the  number  you  specify  for  CONTENT  has  one  minute  to 
issue  the  "Accept  Connections  (from)  YOUR  TTY  NUMBER  (for)  Input  (and  Output) 
command.  Terminate  the  Connection  by  hitting  <  CTRL-P  >  twice.  See  also:  Connect 
TTY  Output. 


TTY:  Connect  (to)  TTY  (number)  CONTENT  (for)  Input/Output  ...  Output  (only)  mode  is  like 
the  TENEX  LINK  command.  Input  (and  output)  mode  works  like  the  TENEX  ADVISE 

command. 

Output:  Connect  (to)  TTY  (number)  CONTENT  (for)  Output  (only)  OK:  The  command 
"Connect  (to)  TTY  (number)"  makes  what  you  type  appear  at  the  other  terminal  and 
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visa  versa.  To  find  someone’s  terminal  number,  use  the  WHERE  or  SYSTAT  commands 
in  TENEX.  Follow  the  "Connect"  command  with  the  semicolon  command. 
<CTRL-P>,  <CTRL-0>  or  the  Disconnect  command  will  break  the  connection. 

DNLS  usage:  The  DNLS  user  may  communicate  with  TNLS  users  and  other  DNLS 
users  with  Base’s  Connect  to  TTY  command.  Once  connected,  use  the  TTY 
window  to  see  what  the  other  user  is  doing,  or  go  to  the  TENEX  level.  You  will 
be  able  to  see  anything  a  TNLS  user  is  doing  while  you  are  linked  to  him.  The 
only  actions  of  another  DNLS  user  you  will  see  is  whatever  would  appear  in  his 
TTY  window  or  at  his  TENEX  level.  This  is  enough  if  you  intend  just  to 
comment  (Semicolon  command).  To  see  everything  a  DNLS  user  does,  i.e.,  share 
viewing  a  file  with  her/him  (but  not  cursors),  use  Base’s  Connect  to  Display 
command.  See  also:  Connecting,  Connect  TTY,  Connect  Display,  TTY-window, 
cursor,  semicolon. 

TNLS  example: 

BASE  C:  Connect  (to)  C:  TTY  (Number)  T:  27 

C:  Input  and  Output  OK: 

BASE  C: 

linking:  See  connecting. 

CONTENT  wants  the  user’s  TTY  number:  (this  is  the  number  the  system  assigns 
to  each  terminal).  Warning:  Connecting  TTY’s  might  affect  the  other  user’s  job  if 
she  is  in  NDNLS,  OUTPRC,  L10,  or  other  special  subsystems;  EXEC  (TENEX), 
TNLS,  NTNLS,  or  DNLS  are  usually  safe.  Use  the  WHERE  command  in 
TENEX  for  all  this  information  about  another  user.  See  also:  CONTENT,  TENEX, 
WHERE. 

See  also:  semicolon,  Disconnect,  Terminals. 

Input:  [TNLS  only]  Connect  (to)  TTY  (Number)  CONTENT  (for)  Input  (and  Output) 
OK:  If  you  specify  the  Input  (and  Output)  mode,  you  will  be  advising  the  job  at  the 
terminal  number  you  specify  for  CONTENT.  This  means  the  person  to  whom  you  are 
connecting  must  issue  the  "Accept  Connection"  command  and  any  commands  you  give 
will  occur  to  the  person  you  are  linked  to  and  not  to  yourself.  For  conversation,  use  the 
Output  (only)  mode.  Do  not  use  this  command  in  DNLS,  use  the  Connect  (to)  Display 
command  instead.  To  find  someone’s  terminal  number,  use  the  WHERE  or  SYSTAT 
commands  in  TENEX.  <  CTRL-P  >  or  the  Disconnect  command  will  break  the 
connection.  See  also:  semicolon,  Disconnect,  Terminals. 

TNLS  example: 

BASE  C:  Connect  (to)  C:  TTY  (Number)  T/[A]:  5(for)  C:  Output  (Only)  OK: 

BASE  C: 

linking:  See  connecting. 

Connected  terminals  for  DNLS  users:  See  connect  display. 

Connecting  -  used  in  two  senses: 

connecting  to  directories:  See  connect  directory. 

connecting  terminals:  [linking].  Connecting  terminals  enables  a  user  to  communicate  with 
another  user  who  is  currently  logged  into  ARC.  A  DNLS  or  TNLS  user  may  connect,  or 
"link",  her  terminal  with  any  other  by  specifying  the  Connect  to  TTY  command.  To 
communicate,  linked  users  first  type  a  semicolon  before  each  new  comment  so  that  their  typed 
input  is  not  taken  as  commands.  Everything  else  done  in  TNLS  or  TENEX  also  appears  on 
both  terminals.  It  is  best  to  respond  in  turn  to  each  other;  simultaneous  typing  by  both  users 
causes  characters  to  interleave.  There  is  a  special  Connect  to  Display  version  of  linking  for 
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DNLS  users  to  share  the  same  views  of  the  same  file.  Either  user  may  break  the  connection 
with  the  Disconnect  command. 

Connect  to  TTY  command  in  Base:  [This  is  Linking  for  both  TNLS  and  DNLS 
users].  See  connect  TTY. 

Disconnect  Terminal  command  in  Base:  See  disconnect. 

Connected  terminals  for  DNLS  users:  See  connect  display. 

Where  command  in  TENEX:  See  Where. 

connection:  See  terminals. 

Connections:  The  Lineprocessor  must  be  connected  to  a  source  of  computer 
service.  It  may  be  wired  permanently  to  a  computer  or  to  a  TIP  with  access  to 
the  ARPANET,  or  it  may  be  connected  to  a  telephone  through  a  box  called  a 
modem  with  or  without  an  acoustic  coupler  that  cradles  the  receiver. 

Console:  See  DNLS. 

content  search:  "TYPEIN":  A  string  of  text  enclosed  in  double  quotes  causes  a 
search  for  all  of  the  Users,  Groups,  or  Organizatons  (in  that  order)  that  have  that 
text  in  their  name.  <CTRL-0>  stops  the  search  of  the  Users  to  begin  the  search 
of  the  Groups  and  stops  the  search  of  the  Groups  to  begin  the  search  of 
Organizations. 

content-analysis  and  sequence  generator  viewspecs:  i,  k,  j,  O,  P.  5ee 

also:  content-analyzer. 

i  ViewspeC:  analyze  the  content  of  statements:  5eei. 

j  ViewspeC:  don't  filter  statements:  5eej. 

k  ViewspeC:  show  next  filtered  statement:  Seek. 

semicolons:  set  off  content-analyzer  patterns  in  links:  See  semicolons. 

Capital-0  ViewspeC:  user  sequence  generator  on:  See  Capital-O. 

Capital-P  ViewspeC:  user  sequence  generator  off:  See  Capital-P. 

COntent-analyzer:  a  process  that  checks  the  characters  in  each  statement.  It 
"passes"  the  statement  so  it  can  be  viewed  and/or  modifies  the  statement 
depending  on  the  content-analyzer  being  used.  It  is  evoked  by  the  use  of 
content-analysis  viewspecs:  i  or  k.  You  choose  content-analyzers  by  specifying  a 
content-analyzer  pattern,  or  a  content-analyzer  program. 

content-analysis  viewspecs:  See  content-analysis, 
pattern:  content-analyzer  pattern:  See  pattern, 
program:  content-analyzer  program:  See  program, 
steps  in  using  a  content-analyzer:  See  steps. 

Content-analyzers:  5eeC!ass-ll.  See  also:  content-analyzer. 

content-pattern:  See  content-analyzer. 

content-search:  See  contentaddress. 
content: 
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content-analyzer  patterns  and  programs:  See  content-analyzer . 

CONTENT:  the  part  of  a  command  asking  you  to  TYPEIN  characters.  You  may  also  give  an 
ADDRESS  for  the  CONTENT  if  you  precede  the  ADDRESS  with  <CTRL-U>.  In  TNLS, 
CONTENT  asks  for  a  TYPEIN  or  OPTION  ADDRESS  and  is  prompted  by  T/[A]:.  See 
also:  CHARACTERS,  FILEADDRESS.  pointing,  prompts,  TNLS. 


ADDRESS  is  an  OPTIONal  alternative;  Type  an  OPTION  character  <  CTRL-U  >  to  give  an 
ADDRESS.  See  also:  OPTION.  See  address. 

In  DNLS,  you  can  also  BUG  the  CONTENT  (prompted  by  B/T/[A]:  ).  See  BUG. 

CONTENTADDRESS:  "TYPEIN"  =  2w3S  (surrounded  by  quotes):  an  address  element  that 
allows  you  to  search  for  a  specific  content  that  you  specify  for  TYPEIN.  This  may  be  followed 
by  "  =  "  and  a  Number  N  and  a  "w",  indicating  the  Nth  occurrence  of  TYPEIN  as  a  word. 

It  may  be  further  followed  by  a  Number  N  and  an  "s"  meaning  to  search  only  within  N 
statements.  A  "c"  for  content  can  be  used  instead  of  a  w  to  mean  the  Nth  occurrence  of 
TYPEIN  as  any  string.  If  no  numbers  or  letters  are  specified  it  will  be  taken  to  be  one  content 
(lc):  search  all  the  following  statements  in  the  file  for  the  next  occurrence  of  TYPEIN  as  any 
string.  You  may  not  search  for  any  string  bounded  by  quotes. 

EXAMPLE:  ".  P"  will  be  a  content  search  for  ".  P" 

word-search:  "word"  =  w  See  word -search. 

control-characters:  See  CTRL-character. 

Control  characters:  The  Useroptions  subsystem  command  "Control"  allows  you 
to  assign  certain  Command  Control  Functions  (like  Command  Accept,  Repeat, 
etc.)  to  any  special  characters  you  choose.  You  can  write  one  set  of  definitions 
for  each  kind  of  terminal  you  use. 

syntax:  Control  (characters  for  terminal)  DEVICES  OK  (control  character) 

CONTROLFUNCTIONS  (character(s))  CONTENT  (echo  as)  CONTENT  OK: 

DEVICES  =  Tasker  or  Ti  (terminal)  or  NVT 
or  Lineprocessor  or  Imlac  or  Execuport 
or  33-TTY  or  35-TTY  or  37-TTY 

CONTROLFUNCTIONS  =  Ca  or  Cd  or  Rpt  or  Insert 
or  Be  or  Bw  or  Bs  or  Litesc 
or  Ignore  or  Sc  or  Sw  or  Tab. 

Effects:  Users  often  change  NLS  control  characters  to  avoid  characters  that  mean  something  else 
on  their  local  system.  Some  Control  Functions  have  standard  unalterable  characters.  All  have 
other  default  assignments  which  will  be  overridden  by  any  other  special  characters  you  define 
with  this  command.  When  it  asks  you  "character(s)"  you  may  type  as  many  keys  for  each 
character  as  you  like.  Repeat  the  command  to  set  definitions  for  other  terminals  and  other 
control  functions.  This  command  will  take  effect  immediately  and  for  all  future  NLS  sessions 
until  you  return  to  the  defaults  with  the  Reset  Control  command.  You  may  see  your  current 
list  of  definitions  with  the  Show  Control  command. 

What  "echo  as"  wants:  Specify  the  character  that  will  print  when  the  function  is  used. 

Note  on  DEVICES:  NVT  means  "Network  Virtual  Terminal".  Specifying  Tasker,  Imlac,  or 
Lineprocessor  will  set  up  definitions  only  for  the  use  of  DNLS  from  that  terminal.  All  others 
set  up  definitions  for  TNLS.  When  you  run  TNLS  from  EXEC  on  one  of  those  display 
terminals,  you’ll  get  the  character  set  for  TI;  going  into  TNLS  via  Simulate  command  gets  you 
the  set  for  the  terminal  you  specify. 

Command  control  functions:  See  controlfunctions. 

See  also:  CTRL-characters,  Terminals,  Useroptions  Reset  Control,  Useroptions  Show  Control. 
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Copy:  The  command  "Copy"  allows  you  to  reproduce  a  SOURCE  you  specify  at 
the  DESTINATION  you  specify.  See  also:  SOURCE,  DESTINATION. 

STRING:  Copy  STRING  (from)  SOURCE  (to  follow)  DESTINATION  OK:  This  group  of 
"Copy"  commands  reproduces  a  STRING  at  another  location. 

TNLS  example: 

BASE  C:  Copy  C:  Word  (from)  A:  02  +2w 
(to  follow)  A:  05  + 1  w 
BASE  C: 

Effects:  SOURCE  also  provides  you  the  choice  of  TYPEIN,  that  is,  you  can  "insert"  a 
new  STRING,  instead  of  "copying"  one,  into  the  new  location  with  this  command. 
After  execution,  you  are  at  the  last  character  of  the  new  STRING. 

STRING:  Character,  Text,  Word,  Visible,  Invisible,  Number,  or  Link  See  String. 

STRUCTURE:  Copy  STRUCTURE  (from)  SOURCE  (to  follow)  DESTINATION  [(Filtered:) 
FILTER]  LEVEL-ADJUST  OK:  This  group  of  "Copy"  commands  reproduces  the 

STRUCTURE  at  another  location. 

TNLS  example: 

BASE  C:  Copy  C:  Branch  (from)  A:  5d 
(to  follow)  A:  lc 
L: 

BASE  C: 

Effects:  SOURCE  also  provides  you  the  choice  of  TYPEIN,  i.e.,  you  can  "insert"  a  new 
statement,  instead  of  "copying"  one,  into  the  new  location  with  this  command.  After 
execution  the  same  STRUCTURE  exists  in  two  places,  and  you  are  at  the  first  character 
of  the  new  STRUCTURE.  Note-Copy  does  not  pay  attention  to  the  Viewspecs  you  have 
on  (i.e.,  it  works  throughout  the  STRUCTURE  you  point  to  whether  all  of  it’s  visible  to 
you  or  not),  unless  you  specify  VIEWSPECS  in  the  FILTER  option,  which  pays 
attention  to  level,  content  analyzer,  and  sequence  generator  Viewspecs.  You  cannot  limit 
the  effects  to  certain  lines  (like  first  lines  only)  with  this  command. 

STRUCTURE:  Statement,  Branch,  Plex,  or  Group:  See  Structure: 

Directory:  Copy  Directory  (of)  CONTENT  (to  follow)  DESTINATION  LEVEL-ADJUST 

[DIROPT]  OK: 

The  command  "Copy  Directory"  copies  any  directory  as  a  plex  following  the  address  you 
specify  for  DESTINATION.  CONTENT  lets  you  type  or  point  to  the  name  of  the  directory. 
After  execution,  you  are  at  the  first  character  of  the  first  statement  of  the  copied  directory. 

TNLS  example.- 

BASE  C:  Copy  C:  Directory  (of)  OK/T:  MaBell 
(to  follow)  A:  3d 
L:  d 

BASE  C: 

DIROPT  option:  5eediropt. 

File:  Copy  File  (from)  CONTENT  (to)  CONTENT  OK:  The  command  "Copy  File"  copies  the 
file  from  the  FILEADDRESS  you  specify  to  the  new  name  at  the  second  FILEADDRESS  you 
specify.  It  will  not  work  when  the  file  to  be  copied  is  loaded.  See  also:  MODIFICATION, 
FILEADDRESS,  CONTENT,  CREATING. 

TNLS  example: 

BASE  C:  Copy  C:  File  (from)  T/  [  A  ] :  pooh(to)  T /  [  A  ] :  tiger 
Copied  Files  Are: 

<  WEINBERG,  POOH.NLS;61,  >  [and  PC]  to  <  WEINBERG,  TIGER. NLS;61,  >  [and  PC] 
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<  WEINBERG,  POOH.NLS;60,  >  to  <  WEINBERG,  TIGER. NLS;60,  > 

BASE  C: 

Effects:  It  will  not  work  when  the  file  to  be  copied  is  loaded.  You  must  go  to  another  file 
and  use  the  copy  command  from  there.  If  you  are  modifying  the  file,  it  also  creates  a 
modification  file  with  the  new  filename.  Copy  file  obeys  the  rules  of  privacy  and 
protection:  you  can  copy  only  files  you  can  read,  only  into  directories  where  you  can 
write.  Copy  File  fails  to  rewrite  the  origin  statement.  See  also:  file,  privacy, 
protection,  directory,  write,  modification,  username. 

Sequential:  Copy  Sequential  (file  from)  CONTENT  (to  follow)  DESTINATION 

LEVEL-ADJUST  (using)  SEQTYPE:  The  command  "Copy  Sequential"  copies  the  text  from 
the  sequential  file  at  the  FILEADDRESS  you  specify  (for  CONTENT)  into  the  NLS  file  at  the 
DESTINATION  you  specify. 

SEQTYPE  = 

One  (<CR>  to  end  statement)  OK:  Each  line  of  the  sequential  file  will  be  a  statement, 
its  level  determined  by  the  number  of  spaces  or  tabs  at  the  beginning  of  the  line.  Blank 
lines  will  show  up  as  separate  statements  containing  one  space.  We  recommend  you  use 
Two  <CR>’s  to  end  the  statements. 

Two  (<CR>S  ends  Statement)  Justified/OK:  A  new  statement  will  occur  after  two 
successive  carriage  returns.  Single  carriage  returns  which  occur  after  62  characters  will 
be  changed  into  spaces.  The  statement  level  is  taken  from  the  lesser  indentation  of  the 
first  two  lines  of  the  statement. 

Justified  (delete  extra  <SP>)  OK:  this  Copy  Sequental  (file)  command  will 
remove  multiple  spaces  from  lines  which  have  been  right  justified  in  the  source  file. 
It  will  only  remove  multiple  spaces  from  lines  longer  than  62  characters. 

Assembler  OK:  This  is  for  Assembler  Programs. 

See  also:  Programs  message  copy. 

correcting  errors:  To  escape  from  a  command  you  have  started,  type 

<  CTRL-X  > .  To  backspace  and  delete  one  character  in  a  TYPEIN,  type 

<  CTRL-A  > .  To  backspace  and  delete  back  to  the  previous  word,  type 

<  CTRL-W  >  .  The  commands  people  use  most  often  to  correct  errors  in  text  that 
is  already  online  are  Substitute  and  Replace.  Use  the  Delete  Modifications 
command  to  erase  modifications  you  have  made  since  your  last  "Update". 

The  Delete  Modifications  command:  See  Delete  modifications. 

common  error  messages  and  what  to  do  about  them:  See  Error. 

<CR>:  the  typewriter  key  that  is  used  for  a  carriage  return.  The  notation  <CR> 
represents  carriage  return.  Carriage  return  is  the  default  character  in  TNLS  for  a 
CA.  See  also:  CA,  notation. 

Create  File  CONTENT  OK:  The  command  "Create  File"  makes  a  new  file  in  a 
directory.  It  will  give  the  new  file  the  name  you  specify  for  CONTENT,  load  the 

file,  and  insert  the  origin  statement.  You  will  be  at  the  first  character  of  the 

origin  statement.  A  new  file  or  version  can  also  be  created  whenever  you  update, 
move,  output,  or  copy  a  file.  See  also :  file,  directory,  origin,  statement, 
loading,  FILEADDRESS,  CONTENT. 

TNLS  example: 

BASE  C:  Create  C:  File  T:  bebop 

BASE  C: 
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The  Insert  Statement  Command:  See  insert  statement. 

Other  commands  that  can  can  create  new  files  or  new  versions  of  files: 

Update  File:  See  Update. 

Copy  File:  See  Copy  file. 

Output  commands:  There  are  options  that  create  new  files  in  the  following  Output 
commands: 

Output  Com:  See  output  com. 

Output  Journal:  See  output  journal. 

Output  Printer:  See  output  printer. 

Output  Quickprint:  See  output  quickprint. 

creating  files:  See  create. 

Crt:  acronym  for  Cathode  Ray  Tube:  See  Display. 

CTRL:  The  control  shift  key  on  the  keyboard:  See  CTRL-character . 

<CTRL-A>:  Backspace  Character  (BC):  See  Character  (backspace). 

<CTRL-B>:  OKREPEAT:  See  OKREPEAT.  See  also:  OK. 

<CTRL-C>  TENEX  ATTENTION:  Typing  the  character  <CTRL-C>,  gets  the 
attention  of  the  timesharing  system,  TENEX.  It  interrupts  your  NLS  session  and 
forgets  any  characters  you  typed  ahead.  If  you  want  to  return  to  NLS,  by  typing 
"con,  "  you  can  only  execute  simple  TENEX  commands  and  you  may  not  call 
other  subsystems  such  as  Telnet.  It  is  best  to  use  the  Quit  NLS  command  instead 
of  <CTRL-C>.  To  return  to  NLS,  type  "con"  at  the  herald  and  strike  carriage 
return.  (For  TNLS,  the  system  will  in  no  way  signal  your  return,  since  you 
continue  at  the  exact  point  of  departure.) 

Quit  command:  See  Quit. 

CTRL  — character:  <CTRL-  >  :  By  holding  down  the  control  key  (CTRL  on  most 
terminals)  while  typing  a  specified  letter,  you  can  produce  special  characters  called 
control  characters.  <CTRL-(some  letter)  >  is  the  notation  used  to  represent 
control  characters.  Control  characters  have  specific  functions  (listed  below)  and 
ordinarily  do  not  print.  If  they  are  printed  in  text,  they  will  show  up  as  a  string 
of  four  characters  (i.e.,  <  tL>)  that  act  as  if  they  were  a  single  character.  You 
can  allocate  the  functions  of  control  characters  to  other  characters  by  using  the 
useroptions  subsystem.  See  also:  invisible,  control  (USEROPTIONS) . 

<CTRL~D>:  Command  Accept  (CA):  See  CA. 

<CTRL-E>:  OKINSERT:  See  OKINSERT. 

<CTRL-F>:  filename  recognition:  5eeESC. 

<CTRL-G>:  ring  bell:  Typing  the  character  <  CTRL-G  >,  when  you  are  connected 
to  another  user,  will  ring  a  bell,  or  you  will  see  a  visual  equivalent.  See  also: 
connect. 

<CTRL~H>:  Program  interrupt  for  NDDT:  Typing  <CTRL-H>  can  usually  be 
used  for  BC.  See  also:  NLS- DDT. 
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<CTRL-I>:  TAB:  5eetab. 

<CTRL-J>:  Linefeed  <  LF  >  :  5eelf. 

<CTRL~K>:  not  used  in  NLS. 

<CTRL-L>:  formfeed:  See  formfeed . 

<CTRL-M>:  carriage  return:  See  cr. 

<CTRL-N>:  <  NULL  >  :  Seenull. 

<CTRL-0>:  stop  process:  Typing  the  character  <CTRL-0>  any  time  stops  the 
process  you  are  doing  such  as  printing  or  searching.  One  time  is  enough,  but  it 
sometimes  takes  a  while  to  take  effect.  Be  patient.  See  also:  Print. 

<CTRL-P>:  Disconnect  connected  jobs:  See  connect  display  input. 

<CTRL-Q>:  HELP  signal:  Typing  the  character  <CTRL-Q>  at  any  point  in  a 
command  provides  a  description  about  what  you  were  doing  and  places  you  in  the 
Help  command  which  allows  you  to  ask  for  the  meanings  of  other  terms.  See 
also:  Help.  COMPARE:  questionmark. 

<CTRL-R>:  Reprint  line  so  far:  Typing  the  character  <CTRL-R>  in  the  middle 
of  inserting  will  show  you  a  clean  line  of  what  you  have  done.  This  is  handy  if 
you  have  been  doing  a  lot  of  backspacing.  See  also:  control,  insert. 

<CTRL-S>:  Show  this  command’s  syntax.  See  notation. 

<CTRL-T>:  TIME  and  LOAD:  Typing  the  character  <CTRL-T>  will  print  the 
current  date,  time,  your  computer  status,  the  system  load  average,  and  how  much 
CPU  time  you  have  used  and  how  much  real  time  you  have  used.  It  does  all  this 
without  disturbing  anything  you  are  doing  even  if  you  are  in  the  middle  of  a 
command.  If  it  says  "IO  WAIT",  then  usually  it  is  waiting  for  you  to  do 
something.  If  it  says  "RUNNING"  then  you  are  waiting  for  it  (though  you  can 
type  ahead  until  the  bell  rings). 

<CTRL-U>:  OPTION  character:  SeeOptional. 

<CTRL-V>:  Literal  Escape:  See  Literal. 

<CTRL-W>:  Backspace  Word  BW:  See  Word. 

<CTRL-X>:  Command  Delete  CD:  See  CD. 

<CTRL-Y>:  Not  used  in  NLS. 

<CTRL-Z>:  TELNET  RECOGNITION:  Typing  the  character  <CTRL-Z>  gets 
the  attention  of  TELNET.  It  is  also  used  at  the  end  of  a  TENEX 

SENDMESSAGE.  See  also:  network. 

Currentcontext  (length)  NUMBER  OK:  The  Useroptions  subsystem  command 
"Currentcontext"  changes  the  NUMBER  of  characters  that  surround  the 
character  you  are  located  at  as  shown  in  response  to  typing  a  slash.  The  default 
value  is  7  characters.  See  Slash. 

To  see  the  number  of  characters  presently  established:  See  Show  currentcontext 
(USEROPTIONS). 

To  reset  the  currentcontext  length  back  to  7:  See  Reset  currentcontext  (USEROPTIONS). 
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cursor:  5eeBUG. 
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d  ViewspeC:  show  first  level  only:  "Show  first  level  only."  Normally,  all  levels 
are  shown  (standard  viewspecs  w  arid  c);  viewspec  d  changes  your  view  to  show 
only  highest  level  statements.  Unlike  x  (one  line,  one  level)  it  does  not  affect 
number  of  lines  shown.  It  changes  viewspecs  w,  e,  c,  b,  and  a.  Example:  to  show 
only  three  levels  use  the  string  dbb.  See  also:  level,  w,  c,  b,  e,  a,  x. 

D  Viewspec:  don’t  show  statement  names:  "Don’t  show  statement  names."  If 
the  first  word  of  any  statement  is  enclosed  in  the  name  delimiters  defined  for  that 
statement,  it  will  not  be  shown  when  the  statement  is  output  or  viewed.  To  show 
statement  names,  use  Viewspec  C.  See  also:  Statementname,  Capital-C. 

DAE:  Dynamic  Address  Expression:  See  address. 

DARPA:  See  ARPA. 

Dash:  See:  Link,  Stringposition,  Number. 

database:  See  Software. 

DDT:  Acronym  for  Dynamic  Debugging  Tool,  a  program  useful  for  establishing  at 
what  point  in  another  program  a  problem  occured.  SeeNLS-DDT. 

DEC:  Acronym  for  Digital  Equipment  Corporation. 

Decisions  concerning  future  items  to  be  implemented:  See  reporting. 

default:  That  which  occurs  unless  you  specify  otherwise.  For  example,  in  TNLS, 
the  carriage  return  key  is  automatically  (by  default)  the  same  as  command  accept 
unless  you  chose  to  make  another  key  be  command  accept. 

filename  recognition  defaults:  See  recognition. 

default  viewspecs:  See  viewspecs  (USEROPTIONS). 

default  directory  for  links:  See  defaults. 

default  subsystems  and  programs:  5«*show  default  (USEROPTIONS). 

defaults:  The  default  directory  for  links  imbedded  in  a  statement  is  determined  by 
the  Set  Link  default  command.  The  default  file  for  links  is  the  current  file. 
There  can  be  no  default  file  if  the  directory  is  specified.  The  default  ADDRESS 
is  the  current  location  of  the  link.  The  default  viewspecs  or  filter  are  the  current 
ones  in  effect.  When  typing  in  an  address,  the  default  directory  is  the  directory  to 
which  you  are  connected.  See  also:  default. 

Exceptions  for  journal  and  program  files:  ^Exceptions. 
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Set  (directory)  Link  default  for  file  command:  See  Set  Link. 

Deinstitute  PROGTYPE  (program)  OK:  The  Programs’  subsystem  command 
"Deinstitute  PROGTYPE"  deinstitutes  the  type  of  program  you  specify  in 
PROGTYPE  as  one  of  the  commandwords  listed  below.  Does  not  remove  the 
program  from  the  stack  or  buffer.  It  may  be  reinstituted  at  any  time  without 
re-loading  or  re-compiling.  See  also:  instituting.  PROGTYPE  wants  one  of  the 
following  commandwords: 

Content  (analyzer):  See  content  (PROGRAMS). 

Sequence  (generator):  See  sequence. 

Sort  (key  extractor):  5eesort  (PROGRAMS). 

DEL:  See  CD. 

Delete:  The  command  "Delete"  erases  something  you  specify  such  as  a  character, 
word,  statement,  etc.  from  the  DESTINATION  you  specify.  See  also. 
DESTINATION. 

STRING:  Delete  STRING  (at)  DESTINATION  OK:  This  group  of  "Delete"  commands  erases 
the  type  of  STRING  you  specify  from  a  statement. 

TNLS  example: 

BASE  C:  Delete  C:  Character  (at)  A:  1  OK: 

BASE  C: 

Effects:  After  execution,  you  arc  at  the  first  character  following  the  deleted  STRING  (or  at 
the  new  last  character  if  the  deletion  included  the  end  of  the  statement). 

STRING:  Character,  Text,  Word,  Visible,  Invisible,  Number,  Link:  See  string. 

STRUCTURE:  Delete  STRUCTURE  (at)  DESTINATION  [(Filtered:)  FILTER]  OK: 

This  group  of  "Delete"  commands  erases  the  type  of  STRUCTURE  you  specify  from  a  file. 

TNLS  example: 

BASE  C:  Delete  C:  Branch  (at)  A:  2 

OK: 

BASE  C: 

Effects:  You  may  not  use  Delete  Statement  if  the  statement  has  substructure  (instead,  try 
Delete  Branch  with  a  FILTER  of  Viewspec  e;  See  also:  FILTER).  After  execution,  you 
are  at  the  first  character  of  the  next  statement  following  the  deleted  STRUCTURE  (or 
the  new  last  statement  if  you  deleted  the  last  statement  in  the  file).  Note-Delete  works 
throughout  the  STRUCTURE  you  point  to  whether  all  of  it’s  visible  to  you  or  not, 
unless  you  specify  VIEWSPECS  in  the  FILTER  option. 

FILTER  option:  enter  VIEWSPECS:  This  option  selects  statements  to  be  deleted  by 
certain  viewspecs  you  can  specify  as  a  string  of  character  codes.  Type  the  OPTION 
character,  <  CTRL-U  > ,  first  and  then  enter  any  combination  of  the  following  Viewspecs: 
for  level-a,  b,  c,  d,  e,  w,  x,  for  content  analyzer-i,  j,  k,  for  sequence  generator-O,  P. 
Statements  which  are  left  somewhere  without  a  source,  because  the  source  passed  the 
FILTER  (and  thereby  got  deleted)  although  they  didn’t,  will  be  promoted  up  in  level. 

See  also:  substructure,  next,  viewspecs,  source,  level,  LEVEL-ADJUST. 

STRUCTURE:  Statement,  Branch,  Plex,  or  Group:  See  structure: 

All:  Delete  All  (markers)  OK:  The  command  "Delete  AH"  (markers)  erases  all  the  markers  in 
the  file  you  have  loaded. 

TNLS  example: 
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BASE  C:  Delete  C:  All  (markers)  OK: 

BASE  C: 

Effects:  If  you  want  to  delete  only  one  marker,  use  the  Delete  Marker  command.  To  see  a 
list  of  the  markers  in  your  file  use  the  command  Show  File  Marker  list. 

See  also:  markers,  Mark,  Delete  Marker,  Show  File  Marker. 

Edge:  Delete  Edge  (at)  BUG  OK:  The  command  "Delete  Edge"  erases  a  window  created  by  the 
Insert  Edge  command.  It  will  keep  the  window  in  which  the  cursor  is  residing  when  you  hit 
OK.  Once  a  window  has  been  deleted,  it  cannot  be  retrieved.  See  also:  Edges,  Insert  Edge, 
Move  Edge. 

File:  Delete  File  CONTENT  OK:  The  command  "Delete  File"  removes  the  file  named  for 
CONTENT  from  normal  use.  If  you  do  not  name  a  directory,  Delete  assumes  you  mean  a  file 
in  your  own.  Expunge  erases  forever  all  deleted  files  in  that  directory.  Undelete  recalls  a  file 
that  has  not  been  expunged.  Deleted  files  risk  being  expunged  periodically  by  the  system. 
Showing  deleted  files  is  an  option  in  the  BASE  subsystem  Show  Directory  command.  See  also: 
FILEADDRESS. 

TNLS  example: 

BASE  C:  Delete  C:  File  T/  [  A  ] :  tiger  OK: 

Deleted  Files  Are: 

<  WEINBERG,  TIGER. NLS;61,  >  and  its  partial  copy 

<  WEINBERG,  TIGER. NLS;60,  > 

BASE  C: 

deletion:  Deleting  a  file  makes  it  disappear  from  the  directory  list.  Until  it  has  been 
expunged  it  can  be  undeleted.  Occasionally  your  deleted  files  will  be  expunged 
automatically.  The  second  oldest  version  of  every  file  is  automatically  deleted  when  you 
create  a  new  version.  You  may  see  files  in  your  directory  with  the  extension  "PC". 
Don’t  delete  them.  They  will  be  deleted  automatically  when  you  use  the  Update  or 
Delete  Modifications  commands. 

Delete  File  command:  See  Delete  File. 

Delete  Modifications  command:  See  Delete  Modifications. 

Expunge  Directory  command:  See  Expunge  Directory. 

Modification  file:  See  Modification. 

Undelete  File  command:  See  Undelete  File. 

expunging  deleted  files:  See  Expunge. 

Effect  On  File  Return  Ring:  If  a  file  is  on  your  File  Return  Ring  and  is  Deleted,  it  will 
continue  to  be  echoed  as  a  choice  on  your  return  ring,  but  you  will  not  be  able  load  the 
file.  If  you  use  the  Undelete  command  before  the  file  is  expunged,  you  will  then  be  able 
to  load  it  again  as  if  you  never  deleted  it.  See  also:  Return. 

Marker:  Delete  Marker  (named)  CONTENT  OK:  The  command  "Delete  Marker"  erases  one 
marker  from  the  file  you  have  loaded. 

TNLS  example: 

BASE  C:  Delete  C:  Marker  (named)  T/  [  A  ] :  tagitOK: 

BASE  C: 

Effects:  Do  not  include  a  pound  sign  (#)  in  your  CONTENT  specification  (unless  you 
made  it  part  of  the  marker  itself  when  you  gave  the  Mark  command).  If  you  want  to 
delete  all  the  markers  in  a  file,  use  the  Delete  All  markers  command.  To  see  a  list  of  the 
markers  in  your  file  use  the  command  Show  Marker  list. 

See  also:  markers,  Mark,  Delete  All,  Show  File  Marker. 

Modifications:  Delete  Modifications  (to  file)  OK:  The  command  "Delete  Modifications" 
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discards  all  changes  you  have  made  on  a  file  since  the  last  update.  The  file  will  return  to  its 
state  after  the  last  Update.  When  you  edit  a  file,  the  changes  build  a  set  of  modifications.  The 
Update  command  fixes  the  changes  permanently  in  the  file.  See  also:  file. 

The  Update  File  command:  See  update. 

TNLS  example: 

BASE  C:  Delete  C:  Modifications  (to  file)  OK:  (really?)  OK: 

BASE  C: 

Delete:  The  Programs'  subsystem  command  "Delete"  clears  your  buffer  space. 
See  also:  buffer. 

All:  Delete  All  (programs  in  buffer)  OK:  The  programs  subsystem  command  "Delete  All"  clears 
your  program  stack,  deinstitutes  all  programs,  empties  the  buffer,  sets  your  buffer  size  back  to 
the  default. 

TNLS  example: 

PROG  C:  Delete  C:  All  (programs  in  buffer)  OK: 

PROG  C: 

Last:  Delete  Last  (program  in  butler)  OK:  The  programs  subsystem  command  "Delete  Last" 
deletes  the  most  recent  program  put  on  your  stack,  deinstitutes  it,  and  frees  its  space  in  the 
buffer.  Does  not  affect  other  programs  or  your  buffer  size  setting. 

TNLS  example: 

PROG  C:  Delete  C:  Last  (program  in  buffer)  OK: 

PROG  C: 

deleted  file:  See  delete  file. 

deleting:  See  delete, 
delimiters: 

statement  name  delimiters:  See  name-delimiters. 

link  delimiters:  See  link. 

Demand:  a  recognition  mode  where  each  commandword  will  be  recognized  after 
you've  typed  enough  characters  to  define  the  commandword  uniquely  (three  are 
enough  except  in  TENEX).  If  you  are  set  for  Demand  recognition,  you  force  a 
word's  recognition  by  typing  either  <  ALT  >  [Alt  Mode  or  Escape  character]  or 
a  space-- <SP>.  It  won’t  take  off  into  the  next  field  until  you  do  this. 

DESTINATION:  prompted  by  A:  (in  TNLS)  or  B/A:  (in  DNLS)  wants  you  to 
POINT  to  something  to  indicate  where  something  is  supposed  to  happen.  In 
TNLS,  DESTINATION  equals  ADDRESS.  In  DNLS  you  can  also  BUG.  See 
also:  pointing,  prompts. 

DEX:  acronym  for  Deferred  Execution.  A  system  for  creating  or  editing  an  NLS 
file  offline,  on  paper  or  magnetic  tape. 

Dialog  Support  Systems  (DSS):  NLS  supports  two  kinds  of  aids  to 
communication:  terminal-to-terminal  linking  and  mail  handling.  In  teletype 

linking,  if  you  type  a  character,  it  also  appears  on  any  terminals  linked  to  you  and 
vice  versa.  If  you  have  the  proper  terminals  you  may  also  link  two-dimensional 
display  screens  and  operate  on  files  both  parties  witness.  Mail  handlings  includes 
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filing  and  cataloging  as  well  as  dissemination;  it  uses  either  the  NLS  sendmail 
system  or  the  TENEX  Sendmessage  system  and  interconnects  them. 

SNDMSG:  TENEX  sndmsg  subsystem:  See  SNDMSG. 

Sendmail  subsystem  of  NLS:  See  sendmail  subsystem. 

linking  between  terminals:  See  connecting. 

shared  screens:  See  connect  display. 

digit:  See  number. 

Ding-a-ling:  See  bells. 

Directive:  See  directives. 

directives:  instructions  imbedded  in  the  text  of  a  file  that  control  the  format  of  a 
file  when  printed.  They  are  interpreted  by  the  Output  Processor.  Directives  take 
the  form:  ".XXX  =  N;"  where  XXX  is  a  mnemonic  such  as  "LBS"  for  lines 
between  statements  and  N  is  a  number.  So,  .LBS  =  4;  would  mean  put  four  lines 
between  each  statement.  For  basic  information,  read  Xprint  among  the  Exercise 
files  described  in  <  userguides,  locator,  > ;  for  more  information  read  the  Output 
Processor  User’s  guide. 

The  Output  Processor  User’s  guide:  A  formatted  paper  copy  of  this  is  available  via 
FEEDBACK.  See  userguides,  op- guide. 

directory  of  interest  to  users: 

printer:  See  printer. 

programs:  See  userprograms. 

userguides:  See  userguides. 

directory-commands:  . 

Connect  (to)  Directory/Display/TTY  ...  :  See  Connect. 

Expunge:  See  Expunge. 

Reset  Link  Default:  Reset:  see  reset  link. 

Set  Link  Default:  Set:  see  set  link. 

Show  File  Default  (directory  for  links):  Show  File:  see  show  file  default  (BASE). 

Show  Disk  (space  status)  command:  See  show  disk  (BASE). 

Trim  Directory  (No.  versions  to  keep)  CONTENT  OK  (really?)  OK:  See  Trim. 

Directory:  a  place  where  files  are  located.  All  directories  have  a  fixed  amount  of 
computer  (disk)  storage  space.  The  user  controls  the  files  in  his  directory  to  keep 
from  going  over  the  allocated  disk  space.  The  name  of  the  directory  is  also  called 
the  "username."  To  find  out  what  files  are  in  your  directory,  use  the  Show 
Directory  command.  In  order  to  write  on  a  file  in  someone  else’s  directory,  use 
the  Connect  to  Directory  command. 

pages  on  the  disk:  Seepages. 

allocation:  file  space  allocation:  See  allocation. 

archiving:  See  archiving. 
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username:  See  directory. 

connecting  to  directories:  See  connect  directory. 

Password:  See  Password, 
commands:  See  directory-commands, 
directories  of  interest  to  users:  See  directories. 

DIROPT:  =  the  options  available  to  you  when  you  use  the  Show  Directory 

command.  Typing  the  OPTION  character  <  CTRL-U  >  ,  when  prompted  by  OPT: 
allows  you  to  use  the  options  listed  below  to  make  a  special  format  for  the 
directory  you  copy.  Added  information  to  be  printed  about  each  file  can  be 
specified  by  these  series  of  options.  ,  [After  each  one  you  enter,  you  will  be  asked 
(Finished?).  If  you  answer  Y(es)  or  OK,  the  option  will  be  terminated;  if  you 
answer  N(o),  you  may  then  enter  another  option  command-word  ] 

Deleted  (files  only):  lists  data  for  files  deleted  but  not  expunged. 

Undeleted  (files  only):  lists  data  for  undeleted  files;  this  is  the  default. 

All  (files):  lists  data  for  both  deleted  and  undeleted  files. 

For  (file)  CONTENT:  lists  only  file  or  files  associated  with  one  name  (affected  by  action  of  star 
convention  and  Altmode). 

Everything:  everything  printable  about  each  file. 

Verbose:  lists  size,  last  writer,  last  write  date,  and  last  read  date  for  each  file. 

Account:  account  number  to  which  file  storage  is  being  charged. 

Protection:  protection  status  of  file. 

Last  (writer):  user  who  last  wrote  on  file. 

Number  (of)  Accesses:  number  of  times  file  has  been  written  and  read. 

Number  (of)  Versions  (to  keep):  lists  the  number  of  versions  of  each  file  now  being  kept. 
Dump  (tape  number):  tape  number  of  last  dump. 

Archive  Status:  one  of  the  following  (See  Archive):  already  archived;  don’t  delete  after 
archiving;  archive  not  allowed,  archive  pending;  no  special  status. 

Archive  Tape  (numbers):  lists  tape  numbers  this  file  is  archived  on. 

Length  (and  bytesize):  size  in  bytes;  then  byte  length  in  parentheses. 

Size  (in  pages):  size  in  disk  pages. 

Miscellaneous:  information  such  as  whether  it’s  a  "long  file"  or  permanent  file. 

Date  (Of)  Archiving:  date  the  file  was  archived  (if  at  all). 

Date  (of)  Creation:  date  this  version  was  created. 

Date  (of)  Last  (dump):  date  this  version  of  the  file  was  last  dumped  on  tape. 

Date  (Of)  Original  (version  creation):  date  first  version  of  this  file  was  created. 

Date  (of)  Read:  date  file  was  last  opened  for  read  access. 

Date  (of)  Write:  date  file  was  last  written  on. 

Time  (and  date  of)  Archiving:  time  and  date  the  file  was  archived  (if  at  all). 

Time  (and  date  Of)  Creation:  time  and  date  this  version  was  created. 

Time  (and  date  Of)  Last  (dump):  time  and  date  this  version  of  the  file  was  last  dumped  on 
tape. 
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Time  (and  date  Of)  Original  (version  creation):  time  and  date  first  version  of  this  file  was 
created. 

Time  (and  date  Of)  Read:  time  and  date  file  was  last  opened  for  read  access. 

Time  (and  date  Of)  Write:  time  and  date  file  was  last  written  on. 

(Note)  NULL/Reverse  means  that  you  can  specify  the  command-word  Reverse,  or  that  you  can  do 
nothing  for  this  field  and  go  on  to  the  next  command-word. 

Group  (group  by)  NULL/Reverse  No  (grouping):  Backs  out  of  grouping;  files  will  not  be 
listed  in  categories;  the  Sort  options  can  still  be  used  to  sort  the  whole  list.  Whether  you 
specify  Reverse  or  omit  it  has  no  effect  on  this  DIROPT. 

Group  (group  by)  NULL/Reverse  Account:  Files  charged  to  the  same  account  number  will 
be  grouped  together,  with  groups  sorted  highest  number  first  for  Reverse. 

Group  (group  by)  NULL/Reverse  Archive  Date:  Files  archived  on  the  same  date  will  be 
grouped  together,  with  groups  sorted  most  recent  date  first  for  Reverse. 

Group  (group  by)  NULL/Reverse  Archive  Status:  Files  with  the  same  archive  status  will  be 
grouped  together. 

Group  (group  by)  NULL/Reverse  Archive  Tape:  Files  stored  on  the  same  archive  tape  will 
be  grouped  together,  with  groups  sorted  highest  tape  number  first  for  Reverse. 

Group  (group  by)  NULL/Reverse  Creation  (date):  Versions  created  on  the  same  date  will 
be  grouped  together,  with  groups  sorted  most  recent  date  first  for  Reverse. 

Group  (group  by)  NULL/Reverse  Deletion  (status):  Separates  deleted  from  Undeleted  files 
if  you  also  ask  for  All  (files),  with  deleted  files  first  for  Reverse. 

Group  (group  by)  NULL/Reverse  Dump  Date:  Files  last  dumped  on  tape  on  the  same  date 
will  be  grouped  together,  with  groups  sorted  most  recent  date  first  for  Reverse. 

Group  (group  by)  NULL/Reverse  Dump  Tape:  Files  dumped  on  the  same  tape  will  be 
grouped  together,  with  groups  sorted  highest  tape  number  first  for  Reverse. 

Group  (group  by)  NULL/Reverse  Last  (writer):  Files  with  the  same  last  writer  will  be 
grouped  together. 

Group  (group  by)  NULL/Reverse  Number  (of  versions  to  keep):  Files  with  the  same 
number  of  versions  being  kept  will  be  grouped  together,  with  groups  sorted  highest  number  first 
for  Reverse. 

Group  (group  by)  NULL/Reverse  Original  (version  creation):  Files  whose  original 
versions  were  created  on  the  same  date  will  be  grouped  together,  with  groups  sorted  most 
recent  date  first  for  Reverse. 

Group  (group  by)  NULL/Reverse  Protection:  Files  with  the  same  protection  status  will  be 
grouped  together. 

Group  (group  by)  NULL/Reverse  Read  (date):  Files  with  the  same  date  of  last  read  will  be 
grouped  together,  with  groups  sorted  most  recent  date  first  for  Reverse. 

Group  (group  by)  NULL/Reverse  Write  (date):  Files  with  the  same  date  of  last  write  will 
be  grouped  together,  with  groups  sorted  most  recent  date  first  for  Reverse. 

Sort  (sort  by)  NULL/Reverse  Account:  Sort  WITHIN  groups  (or  sort  the  whole  list  if  it 
hasn’t  been  grouped)  by  files  charged  to  the  same  account  number,  with  highest  number  first 
for  Reverse. 

Sort  (sort  by)  NULL/Reverse  Alphabetical:  Sort  WITHIN  groups  (or  sort  the  whole  list  if 
it  hasn’t  been  grouped)  by  alphabetical  order  of  filenames  (the  sort  will  go  back  to  this  default) 
or,  if  you  specify  Reverse,  by  reverse  alphabetical  order  of  filenames. 

Sort  (sort  by)  NULL/Reverse  Archive  Status:  Sort  WITHIN  groups  (or  sort  the  whole  list 
if  it  hasn’t  been  grouped)  by  files  with  the  same  archive  status. 
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Sort  (sort  by)  NULL/Reverse  Archive  Tape:  Sort  WITHIN  groups  (or  sort  the  whole  list  if 
it  hasn’t  been  grouped)  by  archive  tape  numbers,  with  highest  tape  numbers  first  for  Reverse. 

Sort  (sort  by)  NULL/Reverse  Archive  Time  (and  date):  Sort  WITHIN  groups  (or  sort  the 
whole  list  if  it  hasn’t  been  grouped)  by  time  archived,  most  recent  first  for  Reverse. 

Sort  (sort  by)  NULL/Reverse  Bytesize:  Sort  WITHIN  groups  (or  sort  the  whole  list  if  it 
hasn’t  been  grouped)  by  size  of  bytes,  largest  bytesize  first  for  Reverse. 

Sort  (sort  by)  NULL/Reverse  Creation  (time  and  date):  Sort  WITHIN  groups  (or  sort 
the  whole  list  if  it  hasn’t  been  grouped)  by  time  this  version  was  created,  most  recent  first  for 
Reverse. 

Sort  (sort  by)  NULL/Reverse  Deletion  (status):  Sort  WITHIN  groups  (or  sort  the  whole 
list  if  it  hasn’t  been  grouped)  by  files  with  the  same  deletion  status. 

Sort  (sort  by)  NULL/Reverse  Dump  Tape:  Sort  WITHIN  groups  (or  sort  the  whole  list  if  it 
hasn’t  been  grouped)  by  latest  dump  tape  numbers,  with  highest  tape  numbers  first  for  Reverse. 

Sort  (sort  by)  NULL/Reverse  Dump  Time  (and  date):  Sort  WITHIN  groups  (or  sort  the 
whole  list  if  it  hasn’t  been  grouped)  by  time  of  last  dump,  most  recent  first  for  Reverse. 

Sort  (sort  by)  NULL/Reverse  Last  (writer):  Sort  WITHIN  groups  (or  sort  the  whole  list  if 
it  hasn’t  been  grouped)  by  name  of  last  writer. 

Sort  (sort  by)  NULL/Reverse  Length  (in  bytes):  Sort  WITHIN  groups  (or  sort  the  whole 
list  if  it  hasn’t  been  grouped)  by  size  of  file  in  bytes,  largest  file  first  for  Reverse. 

Sort  (sort  by)  NULL/Reverse  Number  (of)  Accesses. 

Sort  WITHIN  groups  (or  sort  the  whole  list  if  it  hasn’t  been  grouped)  by  number  of  times  written 
and  read,  highest  number  first  for  Reverse. 

Sort  (sort  by)  NULL/Reverse  Number  (of)  Reads:  Sort  WITHIN  groups  (or  sort  the 
whole  list  if  it  hasn’t  been  grouped)  by  number  of  times  read,  highest  number  first  for  Reverse. 

Sort  (sort  by)  NULL/Reverse  Number  (of)  Versions  (to  keep):  Sort  WITHIN  groups  (or 
sort  the  whole  list  if  it  hasn’t  been  grouped)  by  number  of  versions  kept  for  each  file,  highest 
number  first  for  Reverse. 

Sort  (sort  by)  NULL/Reverse  Number  (of)  Writes:  Sort  WITHIN  groups  (or  sort  the 
whole  list  if  it  hasn’t  been  grouped)  by  number  of  times  written,  highest  number  first  for 

Reverse. 

Sort  (sort  by)  NULL/Reverse  Original  (version  creation):  Sort  WITHIN  groups  (or  sort 
the  whole  list  if  it  hasn’t  been  grouped)  by  time  and  date  the  original  version  of  this  file  was 
created,  with  most  recent  first  for  Reverse. 

Sort  (sort  by)  NULL/Reverse  Read  (time  and  date):  Sort  WITHIN  groups  (or  sort  the 
whole  list  if  it  hasn’t  been  grouped)  by  time  last  read,  most  recently  read  first  for  Reverse. 

Sort  (sort  by)  NULL/Reverse  Size  (in  pages):  Sort  WITHIN  groups  (or  sort  the  whole  list 
if  it  hasn’t  been  grouped)  by  size  of  file  in  pages,  largest  file  first  for  Reverse. 

Sort  (sort  by)  NULL/Reverse  Write  (time  and  date):  Sort  WITHIN  groups  (or  sort  the 
whole  list  if  it  hasn’t  been  grouped)  by  time  last  written,  most  recently  written  first  for  Reverse. 

disaster:  See  emergencies, 
disc:  See  pages. 

Disconnect  Terminal  OK:  The  command  "Disconnect  Terminal"  breaks  a 
connection  with  another  terminal  that  either  user  has  established  with  the 
"Connect  Display"  command  or  by  the  "Connect  TTY"  command.  The 
"Disconnect  Terminal"  command  must  be  followed  by  <CTRL-P>  to  restore  the 
screens  of  both  terminals. 
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TNLS  example: 

BASE  C:  Disconnect  C:  Terminal  OK: 

BASE  C: 

See  also:  linking,  Connect  Display,  Connect  TTY. 
disk:  See  pages. 

display  screen:  (window):  a  television-like  screen  that  displays  your  working  text 
(part  of  the  contents  of  some  file).  There  are  also  various  feedback  areas 
occupying  the  top  6  or  8  lines  of  the  screen.  See  also:  terminals. 

file  display  area  of  the  screen- 

TYPEIN  feedback  area:  the  area  of  the  screen  where  the  user  sees  the  new  text  as  she  types  it 
in.  The  top  of  the  working  text  area  is  cleared  as  needed.  When  the  string  of  new  text  is 
completed  and  the  display  is  re-created,  the  new  text  is  placed  in  the  file  where  you  indicated. 
See  also:  TY  PE  I N . 

edges:  See  edges. 

reading  contents  of  files  on  DNLS  screen:  See  viewing. 

feedback  areas- 

COmmand  feedback  line:  the  area  that  stretches  across  your  screen  from  the  left  side,  just 
above  the  display  area.  This  displays  the  command  in  process,  along  with  prompts, 
noisewords,  etc.,  if  they’re  on.  You  can  control  your  command  feedback  by  using  the 
Feedback  and  Prompt  commands  in  the  Useroptions  subsystem.  See  also:  Feedback 
(USEROPTIONS),  Prompt  (USEROPTIONS). 

viewspec  feedback  area:  the  two  lines  in  the  upper  comer  that  indicate  the  current  status  of 
certain  viewspecs  whose  states  are  not  obvious  from  the  appearance  of  the  text  in  the  display 
area.  Most  of  the  time  these  are  subdued,  but  they  are  highlighted  when  viewspecs  are  changed 
by  entering  codes. 

TTY-simulation  window:  See  TTY-simulation. 

current  subsystem  display:  The  name  of  the  subsystem  you’re  currently  in  is  usually  displayed 
in  an  upper  comer  of  the  screen.  See  also:  Subsystem. 

display-commands  only: 

Accept  Connect:  See  accept. 

Clear  (TTY  Window)  OK:  See  Clear. 

Connect  to  Display:  See  connect  display. 

Delete  Edge:  See  delete  edge . 

Freeze  Statement  (at)  DESTINATION  VIEWSPECS  OK:  See  Freeze. 

Insert  Edge:  See  insert  edge. 

Jump  commands  in  all  subsystems:  See  jump. 

Move  Edge:  See  move  edge. 

Release:  See  Release. 

Reset  Character  size:  See  reset  character. 

Reset  TTY  window:  See  reset  TTY. 

Set  Character  size:  See  set  character. 

Set  TTY  window:  See  set  TTY. 

<LINEFEED>  for  DNLS:  See  DNLS. 
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display-control  viewspecs:  DNLS  only:  u,  v,  f,  o,  p.  See  also:  BUTTONS. 

f  ViewspeC:  recreate  window  if  necessary  (DNLS  only):  See  f. 

O  ViewspeC:  frozen  statements  on  (DNLS  only):  See  0. 

p  ViewspeC:  frozen  statements  off  (DNLS  only):  See  p. 

U  ViewspeC:  recreate  display  after  each  change:  Seeu. 

V  ViewspeC:  defer  recreating  display:  See  v . 

Distribute  (for)  CATEGORY  (to)  CONTENT  OK:  The  Sendmail  subsystem 
command  "Distribute''  allows  you  to  specify  to  whom  your  mail  will  be  sent  and 
whether  it  will  be  sent  for  action  or  for  information  only.  CATEGORY  wants 
the  commandword  "Action"  or  "Information  (only)".  CONTENT  wants  a  list 
of  IDENTS  separated  by  commas  to  show  who  will  receive  copies  of  your 
message  or  copies  of  a  citation  with  a  link  (if  a  document).  See  ident. 

Effects:  An  expression  in  parenthesis  typed  immediately  after  an  ident  (that  is  with  no  spaces) 
will  serve  as  a  brief  message  to  that  recipient  only.  You  may  not  use  a  period  (.)  within  the 
parenthesis.  The  default  sendlist  for  a  group  may  be  overridden  to  limit  it  to  the  coordinator 
or  expand  it  to  the  whole  group  by  preceding  the  IDENT  with  &  or  t,  respectively.  For  more 
effects,  see:  Initial,  distribution,  IDENT. 

distribution:  The  list  of  people  (their  IDENTS)  to  which  Sendmail  items  are  sent 
via  SendmaiFs  Distribute  command.  Secondary  distribution  (to  people  not  on  the 
original  IDENTLIST)  is  done  with  SendmaiFs  Forward  command. 

Restricted  Distribution:  See  Restricted. 

Expanded  distribution:  See  Expanded . 

Sendmail’s  Forward  command:  See  forward  (SENDMAIL). 

Sendmail’s  Distribute  command:  See  distribute. 

Divide  CONTENT  OK:  The  calculator  subsystem  command  "Divide"  divides  the 
value  of  the  accumulator  by  the  number  you  specify  for  CONTENT.  See  also: 
operators,  accumulator,  CONTENT,  OK. 

DNLS:  (Display  NLS:)  ARC’s  Online  System  for  use  with  a  terminal  that  displays 
text  two  dimensionally.  It  also  includes  the  use  of  a  keyboard,  a  "mouse,"  and 
optionally  a  "keyset."  You  must  understand  how  to  BUG  in  order  to  use 
DNLS. 

To- get- DNLS:  If  you  have  told  TENEX  you  are  using  an  Imlac  or  Lineprocessor  by  the 
Terminal  type  command  after  logging  into  TENEX,  to  get  into  NLS  type  NLS  after  the 
TENEX  herald.  See  also:  login,  entering-NLS. 

Lineprocessor:  See  Lineprocessor. 

display  screen  (window):  See  display. 

viewing  contents  of  files  on  DNLS  screen:  See  viewing. 

TNLS  simulation:  See  simulation. 

error  messages:  See  error. 

BUG:  To  BUG  in  DNLS:  See  BUG. 

commands  limited  to  DNLS:  See  display-commands. 
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Document:  any  item  over  1000  characters  long  in  the  Journal  or  Sendmail 

subsystem.  It  is  stored  as  a  file  in  the  Journal  directory  that  has  as  its 
FILENAME  its  journal  number.  See  also:  message  (SENDMAIL). 

Documentation:  information  about  NLS.  Documentation  for  NLS  takes  three 
forms:  hardcopy  guides,  online  versions  of  the  hardcopy  guides,  and  a  central 
depository  of  information  about  NLS  queried  online  through  the  Help  command. 
You  are  now  reading  either  <  documentation,  help,  >  or  a  hardcopy  glossary 
derived  from  it.  Online  guides  may  be  found  via  the  file  <  userguides,  locator,  > 
and  reside  mostly  in  the  directory  <  userguides  > .  Hardcopy  documentation  is 
available.  Ask  your  architect,  address  requests  to  the  Ident  Feedback,  or  write  to 
Augmentation  Research  Center,  SRI,  Menlo  Park,  Calif.  94025  (415)326-6200  ext 
3630. 

done:  depending  on  what  you  are  doing,  there  are  several  ways  to  complete  or  be 
"done"  with  an  NLS  task. 

send:  when  you  are  ready  to  send  a  journal  item.  See  send. 

OK:  when  you  are  ready  to  have  a  command  take  place.  5eeOK. 

Quit:  when  you  want  to  leave  the  subsystem  you  are  in.  5eequit. 

Logout:  when  you  no  longer  want  to  work  with  the  computer.  See  logout. 

Command  Delete:  to  erase  a  command  not  yet  confirmed.  See  CD. 

dot:  See  period. 

down:  The  statement  one  level  lower  than  and  following  a  given  statement  (i.e.,  the 
top  substatement).  In  the  illustration  (see  illustration),  statement  1  is  one  down 
from  the  statement  0;  la  is  two  down;  the  down  statement  from  la  would  be  la 
itself  (because  it  has  no  substatement).  See  also:  illustration. 

DSEL:  Destination  SELelection:  See  destination . 

DSS:  acronym  for  Dialog  Support  System:  See  dialog. 
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6  ViewspeC:  level  of  referenced  statement:  "Show  all  statements  at  the  same  level 
as  where  you  are  and  all  higher  level  statements.  Do  not  show  any  lower  level 
statements."  If  you  are  at  a  third  level  statement,  three  levels  would  be  shown. 
Viewspece  is  often  combined  with  b  to  add  levels. 

E  ViewspeC:  paginate  when  printing  (TNLS  only):  "Paginate  when  printing." 
TNLS  will  format  your  text  into  pages-numbered,  separated  by  a  cutting  line 
consisting  of  — ’s,  and  with  margins-when  printing  at  the  terminal  via  any  Print 
command.  This  is  a  default  viewspec.  See  also:  Capita  I  —  F  - 

6ChO:  A  response  from  the  system  to  something  you  typed. 

edgGS:  imaginary  lines  that  can  divide  your  display  window  into  as  many  as  8  parts 
so  you  can  view  something  different  in  each  part.  You  can  add  to  the  number  of 
views  you  can  have  of  the  same  and/or  different  files  by  inserting  edges  with  the 
BASE  subsystem’s  Insert  Edge  command.  To  get  more  windows,  insert  another 
edge.  To  change  the  relative  shape  or  size  of  adjacent  windows,  use  the  Move 
Edge  command.  To  get  rid  of  a  window,  use  the  Delete  Edge  command. 
Subsequent  operations  in  NLS  will  take  place  in  one  of  these  windows  at  a  time, 
whichever  one  contains  your  cursor  when  you  give  the  final  OK. 

See  also:  Insert  Edge,  Move  Edge,  Delete  Edge,  cursor. 

Emptying  windows:  See  Emptying. 

edit:  See  writing. 

Edit:  Edit  Statement  (at)  DESTINATION  EDITSTRING  OK:  The  command 
"Edit  Statement"  (in  TNLS  only)  allows  you  to  move  through  a  statement 
character  by  character,  changing  as  you  go  by  means  of  a  set  of  special  editing 
characters.  (It  resembles  QED  and  TECO.) 

TNLS  example: 

BASE  C:  Edit  C:  Statement  (at)  A:  035 

T:exa<new>mple  edit 

BASE  C: 

Effects:  See  command.  At  confirmation,  the  remainder  of  the  old  statement  copies  to  the  new 
one;  the  new  one  then  replaces  the  old. 

EDITSTRING:  any  combination  of  the  following  control-characters: 

<CTRL-F>:  copies  one  character. 
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<CTRL~U>:  copies  through  end  of  old  statement. 

<CTRL-Z>C:  copies  characters  up  to  and  including  c:  the  next  occurrence  of  the  typed-in 
character  following  it. 

<  CTRL-0>c:  copies  characters  up  to  but  not  including  c:  the  next  occurrence  of  the 
typed-in  character  following  <CTRL-0>. 

<CTRL-S>:  you  skip  one  character. 

<CTRL-G>C:  skips  characters  up  to  and  including  c:  the  next  occurrence  of  the  typed-in 
character  following  <CTRL-G>. 

<CTRL-P>C:  skips  characters  up  to  but  not  including  c:  the  next  occurrence  of  the 
typed-in  character  following  <CTRL-P>. 

<CTRL-E>TYPEIN<CTRL-E>:  Enters  into  the  new  statement:  the  character  string 
(TYPEIN)  between  the  two  <CTRL-E>s  without  affecting  where  you  are  in  the  old 
statement. 

<CTRL-H>:  backspaces  (deletes)  one  character:  in  the  new  without  affecting  where  you 
were  in  the  old  statement. 

<CTRL~W>:  backspaces  (deletes)  one  word:  in  the  new  without  affecting  where  you  were 
in  the  old  statement. 

<CTRL-Q>:  All  editing  prior  to  pressing  this  key  is  voided,  moves  you  to  the  beginning  of 
the  statement. 

<CTRL-N>:  one-character  "restorative"  backspace:  it  deletes  the  last  character  in  the  new 
and  moves  you  back  one  character  in  the  old  statement. 

<CTRL-R>:  reprints  the  existing  part  of  the  new  statement. 

See  also:  editing,  control  (for  control  characters). 

editing  commands:  See  commands  (BASE). 

Editing:  See  writing. 

editor:  the  old  name  of  a  NLS  subsystem  changed  to  Base:  See  base. 

Effects:  The  note  under  the  entry  for  many  commands  describing  special 

side-effects  or  after-effects  of  that  command.  To  see  just  the  description  of  effects 
of  a  command  you  know,  type  the  commandwords  followed  by  the  word 
"effects"  in  the  Help  command. 

Emptying  windows:  describes  a  window  display  that  has  nothing  in  it  except  the 
word  "empty."  The  window  will  remain  this  way  until  you  put  something  there 
by  loading  a  file,  or  by  using  any  of  the  Jump  commands  from  an  old  window  to 
the  new  one  (have  your  cursor  located  in  the  destination  window  when  you 
confirm  the  command).  To  empty  a  full  window  (get  rid  of  its  file  contents  and 
have  it  display  "empty"),  use  the  Clear  Window  command.  See  also:  Load, 
Clear  Window,  Jump. 

end:  The  last  statement  in  the  branch  with  a  given  statement  as  its  source.  The 
end  from  statement  0  is  always  the  last  statement  in  the  file.  In  the  illustration, 
the  end  from  statement  3  is  3c la;  the  end  from  lb  is  lb3.  See  also:  illustration. 

Entering  DNLS:  See  to-get-DNLS. 

entering-NLS:  (How  to  get  NLS):  NLS  runs  as  a  subsystem  of  TENEX.  When 
TENEX  is  ready  for  commands,  you  will  see  an  at  sign  ("@")  at  the  margin. 
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Type  "NLS"  followed  by  carriage  return.  When  you  first  enter  NLS,  the  system 
loads  for  you  a  special  file  called  your  initial  file  and  you  are  in  the  BASE 
subsystem.  Unless  you  have  altered  your  user  options,  the  herald  of  the  BASE 
subsystem,  "BASE,  "  will  appear  at  the  left  margin.  Then  you  may  read  or 
write  on  files.  See  also:  Login,  username,  USEROPTIONS,  reading,  writing. 

initial  file:  See  initial. 

Herald:  See  heralds. 

For  terminals  with  the  Display  NLS  capability:  See  DNLS. 

If  you’re  not  on  a  Tl  (upper/lower  case)  or  TTY-35  or  local  tasker:  See  terminal -type. 

entering  systems- -a  general  orientation:  See  systems. 

Entry  Subsystem/Program  ...  :  The  Useroptions’  subsystem  command 
"Entry"  allows  you  to  specify  the  subsystem  or  program  you  will  be  using  when 
you  enter  NLS.  See  also:  Include  (USEROPTIONS),  Show  Default 

(USEROPTIONS),  programs,  subsystem. 

Subsystem:  Entry  Subsystem  SUBSYSTEM  OK:  The  subsystem  (see  SUBSYSTEM)  you  specify 
will  be  the  one  you  are  in  when  you  enter  NLS.  Specify  a  different  subsystem  to  change  your 
current  entry  subsystem.  Use  the  useroptions’  Show  Subsystems  command  to  see  your  current 
default  subsystem  and  program  status.  See  also:  Entry  Program  (USEROPTIONS),  include 
(USEROPTIONS). 

Program:  Entry  Program  CONTENT  OK:  The  program  at  the  FILEADDRESS  you  specify  for 
CONTENT  will  be  the  one  you  are  in  when  you  enter  NLS.  Use  the  useroptions’  Exclude 
command  to  get  rid  of  subsytems  and  programs.  Use  the  useroptions’  Show  Default  command 
to  see  vour  current  default  subsystem  and  program  status.  See  also:  Entry  subsystem 
(USEROPTIONS),  Include  (USEROPTIONS). 

<EOL>:  end  of  line:  This  is  one  character  which  is  equivalent  to  a  <CR>  followed 
by  an  <  LF  >  . 

erase:  delete,  <CTRL-A>,  <CTRL-W>. 

error  messages:  messages  that  appear  while  you  are  executing  a  process.  They 
usually  indicate  a  software  bug. 

NLS  display  error:  This  by  itself  can  usually  be  solved  by  creating  a  new  window  using  the 
Insert  Edge  command.  If  there  are  other  problems,  see  emergencies. 

Reporting  bugs:  See  reporting. 

Sendmail  errors:  See  error  (SENDMAIL). 

error  messages  in  the  Sendmail  subsystem:  See  initialize. 

<ESC>:  Escape  and  <CTRL-F  >  :  The  keys  that  automatically  finish  typing  a 
filename  or  directory  when  you  have  typed  enough  characters  to  make  the  name 
unique.  Also  called  <ALT>.  If  you  have  not  typed  enough  characters  to  make 
the  name  unique  or  the  file  does  not  exist,  "  <  ESC  > "  will  echo.  Escape  always 
calls  the  highest  version  number.  You  may  use  $  followed  by  SPACE  in  a  link  to 
represent  Escape.  <CTRL-F>  works  as  Escape  in  a  filename  for  a  single  part 
only;  you  then  continue  with  the  next  part.  See  also:  fileaddress. 

escape:  See  < ESC>. 

Evaluate  CONTENT  OPERATOR  OK:  The  Calculator  subsystem  command 
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’Evaluate"  will  evaluate  the  number  you  specify  in  CONTENT  and  type  the 
total.  In  addition,  you  can  specify  an  OPERATOR  (see  arithmetic  operators)  or 
skip  it  by  hitting  CA  when  prompted  by  OK/C:  .  If  you  specify  an  operator,  the 
accumulator  will  then  be  correspondingly  operated  on  in  relation  to  the  total  and 
the  result  will  replace  the  previous  accumulator  value.  The  total  followed  by  an 
asterisk  will  be  entered  in  the  Calculator  file.  See  also:  operators,  accumulator, 
file  (CALCULATOR),  CONTENT,  OK. 

example:  Examples  have  been  written  for  some  TNLS  commands.  Online  in  the 
Help  command  you  may  see  a  TNLS  example  by  typing  the  command  name 
followed  by  the  word  TNLS. 

Exceptions  for  journal  and  program  files:  If  you  give  a  filename  containing 
nothing  but  a  number  and  it  is  not  found  in  your  current  directory,  then  it  is 
assumed  to  be  a  Journal  file  and  the  Journal  is  searched. 

If  you  are  using  the  Programs  subsystem  command  "Load  Program",  then  if  the 
program  is  not  found  in  your  CONNECTED  (not  login)  directory,  then  the 
directory  "PROGRAMS"  is  searched  for  the  program.  See  loading 
(PROGRAMS). 

Exclude  Subsystem/Program  ...  :  The  Useroptions  subsystem  command 
"Exclude  Subsystem/Program"  allows  you  to  delete  subsystems  and  programs 
that  are  available  to  you  when  you  enter  NLS.  See  also:  Include 

(USEROPTIONS),  Show  Default  (USEROPTIONS). 

Subsystem:  Exclude  Subsystem  SUBSYSTEM  OK:  The  subsystem  (see  SUBSYSTEM)  you 
specify  will  not  be  automatically  loaded  when  you  login.  Use  the  Useroptions  Include 
command  to  add  to  subsytems  and  programs  available  when  you  login.  Use  the  Useroptions 
Show  Default  command  to  see  your  current  default  subsystem  and  program  status.  See  also: 
Exclude  (USEROPTIONS),  Include  Program  (USEROPTIONS). 

Program:  Exclude  Program  CONTENT  OK:  The  program  at  the  FILEADDRESS  you  specify 
for  CONTENT  will  NOT  be  automatically  loaded  when  you  login.  Use  the  Useroptions 
Include  command  to  add  to  subsytems  and  programs  available  when  you  login.  Use  the 
Useroptions  Show  Default  command  to  see  your  current  default  subsystem  and  program  status. 
See  also:  Exclude  Subsystem  (USEROPTIONS),  Include  (USEROPTIONS). 

Execute  (command  in)  SUBSYSTEM:  The  command  "Execute"  allows  you  to 
give  one  command  in  a  different  subsystem  and  immediately  returns  you  to  the 
subsystem  you  were  in. 

TNLS  example: 

BASE  C:  Execute  (command  in)  C:  Useroptions 

USER  C:  Show  C:  Viewspecs  OK: 

Viewspecs:  levels:  ALL,  lines:  ALL,  hjnpuzACEHJLP  prompting:  ON 

BASE  C: 

Effects:  After  typing  "Execute"  and  a  subsystem  name,  no  OK  is  required.  You  can 

immediately  begin  the  subsystem  command.  You  can  use  OKINSERT  or  OKREPEAT  to  OK 
the  command  and  you  will  remain  in  the  subsystem  you  have  gone  to.  As  soon  as  you  have 
CONFIRMed  with  Command  Accept  (or  given  a  Command  Delete),  you  will  be  returned  to 
the  subsystem  you  were  in. 

To  go  to  another  subsystem  and  stay  there,  See:  Goto.  See  also:  Quit, 
executing  program  files:  See  running  (PROGRAMS). 
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Expanded  distribution:  III  using  the  Sendmail  subsystem,  when  an  ident  belongs 
to  a  group,  the  group  may  by  default  have  restricted  distribution.  That  is,  items 
sent  to  or  from  it  are  sent  only  to  the  co-ordinator.  In  either  case  you  may 
distribute  an  item  to  the  whole  group  by  putting  an  uparrow  (t)  before  the  ident. 

Restricted  distribution:  See  restricted  (SENDMAIL). 

Expedite  OK:  The  Sendmail  subsystem  command  "Expedite"  marks  expedite  on 
an  item,  but  at  present  nothing  in  NLS  reads  that  mark. 

expressions:  arithmetic  expressions:  See  evaluate. 

Expunge:  to  completely  erase  deleted  files  from  the  running  system.  Deleted  files 
must  be  expunged  before  their  disk  pages  are  free.  After  files  have  been  expunged 
they  cannot  be  undeleted  or  retrieved,  unless  you  try  to  expunge  the  file  in  which 
your  current  marker  resides.  Occasionally  if  the  entire  system  is  low  on  disk 
pages,  it  will  automatically  expunge  your  deleted  files.  See  also:  undelete. 

Directory:  Expunge  Directory  OK.  The  command  "Expunge  Directory"  permanently  erases 
from  the  system  all  deleted  files  in  the  directory  you  logged  in  under  or  subsequently  connected 
to  (unless  the  files  are  being  held  open  by  someone  using  them).  See  Expunge. 

TNLS  example: 

BASE  C:  Expunge  C:  Directory  OK: 

BASE  C: 

Connect  to  Directory  command:  See  Connect  Directory. 

Delete  File  command:  See  Delete  File. 

.EXTENSION;  The  characters  that  follow  the  NAME  of  a  file  to  signify  to  you  and 
the  system  how  to  handle  the  file.  The  extension  may  contain  up  to  39  letters, 
digits,  dashes,  and  a  few  other  special  characters.  It  must  be  immediately 
preceded  by  a  period  and  immediately  followed  by  a  semicolon.  The 
FILENAME  EXTENSION  is  followed  by  the  FILENAME  VERSION.  The 
filename’s  extension  field  for  an  NLS  file  is  .NLS;  Other  extensions  listed  below 
denote  other  functions. 

.PC;  designates:  this  file  is  a  modification  file:  See  modification . 

.TXT;  represents:  a  sequential  file  unloadable  in  NLS.  See  sequential . 

user  programs  extensions:  See  loading. 

External  (names  link  file  address)  CONTENT  OK:  This  useroptions 
subsystem  command  wants  the  ADDRESS  of  a  file  containing  named  statements 
containing  links.  NLS  can  then  go  there  searching  for  an  externalname.  See: 
externalname. 

EXTERNALNAME:  &statementname  (preceded  by  ampersand):  Whenever  an 
external  name  is  specified  in  an  address  or  via  the  Jump  to  Name  External 
command,  it  will  first  Jump  to  Name  Any  on  the  file  in  which  you  are  located;  if 
it  is  not  found,  will  go  to  the  external  name  file  defined  with  the  Base  Set 
External  command;  if  it  finds  the  name  there,  it  will  jump  to  the  link  following 
the  name.  If  no  external  name  file  has  been  defined  for  the  file  you  are  searching, 
the  system  will  look  in  the  file  you  specify  in  the  Useroptions  External  (names  ...) 
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command.  See  also:  JUMP  NAME,  SET  EXTERNAL,  External  (USEROPTIONS), 
STATEMENTNAME,  ADDRESS. 
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f  ViewspeC:  recreate  window  if  necessary  (DNLS  only):  "Re-create  display  screen 
immediately."  Viewspec  f  is  often  used  when  viewspec  v,  which  suppresses  the 
normal  re-creation  of  display,  has  been  set.  Viewspec  f  has  only  a  one-time  effect. 
After  its  use,  whichever  of  codes  u  or  v  was  previously  in  force  remains  so. 
Viewspec  u  re-creates  the  display  whenever  the  view  or  contents  of  the  file(s) 
change.  Use  this  to  see  the  new  view  after  typing  viewspecs  with  mouse  buttons. 
See  also:  u,  v,  viewing,  re-creating,  capital-F. 

F  Viewspec:  TNLS-  no  paging/DNLS:  recreate  display:  TNLS  output  by  Print 
commands  at  your  terminal  will  not  be  separated  by  pages.  To  turn  pagination 
on,  use  Viewspec  E.  See  also:  Paginate,  Print,  Capital- E.  In  DNLS  use 
capital-F  to  be  sure  your  screen  recreates.  See  also:  f. 

FDBK:  See  reporting. 

FEED:  See  feedback. 

feed:  linefeed:  See  If. 

FEEDBACK,  used  in  two  senses: 

Feedback  command  in  the  Useroptions  subsystem:  to  control  what  the  system  types  back 
as  you  use  commands.  See  feedback  (USEROPTIONS). 

Feedback  mechanism  for  Users  to  report  bugs,  complaints,  and  recommendations  to  the  people  who 
maintain  NLS.  They  will  answer  you.  See  reporting. 

Feedback  FEEDSPECS  OK:  The  Useroptions  command  "Feedback"  turns 
noisewords  off  and  on.  For  your  TNLS  sessions,  you  can  specify  how  many 
letters  of  the  commandwords  and  noisewords  appear,  or  indent  the  beginning  of 
each  command  specification. 

TNLS  example: 

USER  C:  Feedback  C:  Terse  OK: 

USER  C:  Goto  C:  Base  OK: 

EDIT  C:  Append  C:  Statement  A:  2 

A:  1 

T:  and 

EDIT  C: 

FEEDSPECS:  prompted  by  C:  asks  you  to  type  in  Terse,  Verbose,  Length  CONTENT  or, 
Indenting  CONTENT.  Verbose,  which  is  the  default,  gives  you  noisewords,  and  Terse,  shuts 
off  noisewords. 


Affects  TNLS  only  -  Length  CONTENT,  Indenting  CONTENT:  To  limit  both 

noisewords  (if  they’re  on)  and  completion  of  commandwords  upon  recognition 
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(independently),  use  Length  and  give  the  number  of  characters  you  want  for  each; 
otherwise,  all  characters  up  to  50  will  appear.  To  indent  the  beginning  of  each 
command,  use  Indenting  and  give  the  number  of  spaces  to  be  indented;  otherwise 
commands  will  not  be  indented.  CONTENT  wants  you  to  give  a  number  either  by 
TYPEIN  or  pointing. 

See  also:  command,  command  recognition,  commandword,  noiseword,  TNLS,  pointing, 
TYPEIN,  CONTENT,  Useroptions  Reset  Feedback,  Useroptions  Show  Feedback. 

ft:  See  formfeed . 

field:  a  portion  of  a  STRING  of  CHARACTERS  that  has  a  special  meaning 
defined  by  its  format  and/or  location.  Such  as: 

Link  fields:  See  link. 

or, 

FILEADDRESS  fields:  See  f Headdress. 

File:  The  basic  unit  in  a  directory.  An  NLS  file  is  made  of  one  or  more  statements 
that  can  be  arranged  at  different  levels  in  an  outline  or  tree  form.  This  structure 
is  called  "hierarchy"  and  the  interrelations  between  statements  are  called 
Structural  Relationships.  Type  the  word  "illustration"  for  a  picture  of  file 
structure.  Create  an  empty  file  with  the  Create  File  command  in  the  BASE 
subsystem.  Existing  files  can  be  accessed  with  a  FILEADDRESS  wherever  A: 
appears.  View  different  levels  of  structure  using  viewspec  clipping.  See  also: 
privacy,  handling,  STRUCTURE, 

illustration  of  file  structure:  See  illustration. 

structural  relationships  within  files:  See  structural. 

Files,  types  of:  See  Files. 

return  ring  for  files:  See  return. 

size  limits:  See  size. 

sendmail  subsystems  File  command:  See  file  (SENDMAIL). 

FILE  as  part  of  a  command:  See f Headdress. 

file  — handling:  See  also:  commands(archiving),  commands(modifying),  commands 
under  each  subsystem,  copy  file,  delete  file,  delete  modifications,  undelete  file, 
undelete  modifications,  move  file. 

handling  whole  files:  NLS  provides  many  commands  that  deal  with  whole  Files  allowing  you  to 
make  changes,  erase  changes  made,  send  Files  to  people,  delete  them,  and  transfer  Files  from  one 
directory  or  site  to  another,  and  return  to  recent  Files  you  have  accessed. 

Copy  Sequential  File:  Copy  See  copy  sequential. 

Create  File  CONTENT  OK:  See  Create. 

Load  File:  Seeload. 

Output  Assembler  file:  Output  See  output  assembler. 

Output  Sequential  file:  Output  See  output  sequential. 

Show  File  Modification  Status:  See  Show  File  modification  (BASE). 

Show  File  Status:  See  show  file  status  (BASE). 
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Set  Temporary  Modifications:  5eeSet  Temporary. 

Renumber  SIDS  (in  file)  OK:  See  Renumber. 

Reset  Temporary  Modifications:  See  Reset  Temporary. 

Update  File:  See  Update. 

Verify  File  OK:  See  Verify. 

file-return  ring:  See  return. 

file:  Calculator  file:  When  you  first  enter  the  Calculator,  it  finds  or  creates  a  file 
named  "CALC-IDENT.  NLS"  in  your  directory.  After  creation,  this  file  is 
loaded  whenever  you  enter  the  Calculator.  This  file  records  the  history  of  your 
work  like  the  tape  of  an  adding  machine.  It  saves  each  arithmetic  operation  and 
records  subtotals  and  totals.  All  items  are  first  level  statements.  A  line  of 
asterisks  marks  the  beginning  of  each  session.  The  Calculator  file  is  a  standard 
NLS  file  and  may  be  printed  like  any  other  NLS  file.  The  Calculator  file  should 
not  be  edited  outside  the  Calculator  subsystem.  With  the  Write  command,  it  may 
be  copied  to  another  NLS  file  which  you  may  freely  edit. 

File:  DESTINATION  OK:  The  Sendmail  subsystem  command  "File"  allows  you 
to  specify  a  file  as  the  material  to  send.  Any  recorded  piece  of  mail  over  a 
certain  length  is  kept  in  the  Journal  in  a  file  with  the  sendmail  number  as  the 
FILENAME.  The  contents  of  Journal  files  are  never  changed.  In  both  TNLS 
and  DNLS,  hitting  CA  will  send  the  file  in  which  you  are  currently  located. 
Alternatively,  you  can  type  the  address  of  any  file. 

Workfile:  SENDMAIL  Workfile:  a  file  that  is  ordinarily  invisible  and  that  contains  the  current 
status  of  your  sendmail  item.  If  you  have  completed  sending  an  item,  this  file  is  empty.  To 
clear  it  out,  use  the  initialize  command  in  the  sendmail  subsystem.  See  also:  SENDMAIL, 
initialize  (SENDMAIL). 

FILEADDRESS:  SITE,  DIRECTORY,  FILENAME,:  a  string  of  names  that 
identifies  a  specific  file  in  a  specific  directory  at  a  specific  site.  A  filename  may  be 
preceded  by  the  name  of  a  directory  which  may  be  preceded  by  the  name  of  a  site 
as  shown  above.  If  you  use  FILEADDRESS  as  part  of  an  ADDRESS,  it  must 
come  first  and  be  followed  by  a  comma  as  above.  A  comma  is  unnecessary  after 
the  FILENAME  in  those  instances  when  only  a  FILEADDRESS  is  called  for, 
not  a  whole  ADDRESS,  such  as  in  the  Load  File  command.  FILEADDRESS 
may  include  stars  or  Alt  Mode  (ALT/ESC)  for  automatic  recognition.  See  also: 
link,  ADDRESS,  pointing,  return,  altmode,  site,  directory,  FILENAME. 

recognition  and  defaults:  See  recognition. 

FILELINK:  See  fileaddress. 

FILENAME:  Each  file  in  the  system  has  a  FILENAME  which  is  divided  into  parts. 
A  period  (.)  and  a  semi  colon  (;  )  divide  the  parts  like  this:  name. extension; 
version.  In  most  cases,  you  need  not  specify  the  extension  or  the  version.  Each 
part  except  the  version  can  be  up  to  39  characters.  When  you  have  typed  enough 
characters  to  make  a  single  part  unique,  <CTRL-F>  will  complete  that  part. 
<ALT>  will  complete  all  parts.  NLS  files  always  have  the  extension  "NLS". 
Version  numbers  go  up  when  you  update.  See  also:  stars,  defaults, 
PROTECTION. 
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.EXTENSION:  See  EXTENSION. 

filenames  in  TENEX:  TENEX  filename  fields  are  different  from  NLS 

FILEADDRESSES  in  that  the  directory  is  delimited  by  angle-brackets  instead  of 
commas.  See  also:  FILEADDRESS,  filename. 

Filereturn  (ring  entries)  CONTENT  OK:  The  Useroptions’  subsystem 
command  "Filereturn"  allows  you  to  change  the  maximum  size  of  your  File 
Return  Ring.  The  default  is  10.  The  maximum  allowed  is  25.  CONTENT 
wants  the  Number  of  entries  for  the  ring.  Each  location  remembered  on  your 
ring  takes  up  space  and  too  many  could  slow  you  down  or  cause  problems.  For 
this  reason  we  recommend  no  more  than  10  except  for  special  cases. 

Effects:  The  commands  won’t  take  effect,  until  you  create  a  new  window  in  DNLS  or  until  your 
next  NLS  session.  They  will  remain  in  effect  for  subsequent  sessions  until  you  change  the  size 
again. 

See  also:  statement  return,  file- return,  CONTENT,  Useroptions  Show  Jump,  Useroptions  Reset 
Jump. 

Files:  types  of.  See  also:  file. 

Archived  file:  See  Archived, 
bad  file:  See  bad. 
deleted  file:  See  delete  file, 
expunged  file:  See  expunge, 
initial  (IDENT)  file:  See  initial. 

MESSAGE.TXT;  TENEX  file:  See  MESSAGE, 
modified  file:  See  modification. 

RSEXEC  file:  See  RSEXEC. 
sequential  file:  See  sequential. 

SENDMAIL  file:  See  file  (SENDMAIL). 

FILTER  (viewspeCS:)  pick  certain  statements  to  be  operated  on.  The  FILTER 
part  of  a  command  must  sometimes  be  preceded  by  <  CTRL-U  >  and  followed  by 
LEVELADJUST.  Enter  any  combination  of  the  following  Viewspecs:  for 
level-a,  b,  c,  d,  e,  w,  x,  for  content-analysis--i,  j,  k,  or  for  sequence  generator-O, 
P.  For  instance,  if  a  STRUCTURE  to  be  copied  is  a  branch  and  you  "FILTER" 
it  through  viewspecs  e  and  b,  only  the  top  statement  and  one  more  level  of  the 
branch  will  be  copied.  When  a  filter  doesn’t  pass  a  statement,  the  substatements 
move  up  a  level.  Line  clipping  viewspecs  currently  do  not  have  effect  in 
FILTERS. 

content-analysis  and  sequence  generator  viewspecs:  See  content-analysis. 

commands  that  use  FILTERS:  The  Print  and  Jump  commands  are  always  affected  by 
level-clipping  viewspecs  and  the  currently  set  content-analyzer  when  viewspecs  i  or  k  are  on. 
The  following  commands  can  optionally  make  use  of  filtering  by  viewspecs  for  the  execution  of 
that  command  only.  See  also:  CLIPPING,  viewspecs,  i,  k. 

Copy  STRUCTURE:  Set*  copy  structure. 

Delete  STRUCTURE:  See  delete  structure. 
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Move  STRUCTURE:  See  move  structure. 

Substitute:  See  substitute. 

Transpose  STRUCTURE:  See  transpose  structure. 

find: 

searching  for  places  in  files:  See  search. 

the  LI 0  "FIND"  construct:  SeeLlO. 

Fixed:  a  recognition  mode  where  all  commandwords  will  be  recognized  after  you 
type  the  first  three  letters.  You  may  NOT  type  more  letters,  because  they  will  go 
into  the  next  field. 

Force  (Case):  The  command  "Force"  allows  you  to  capitalize  or  decapitalize  or 
make  first  letter  capitals  in  the  situations  listed  below.  You  can  also  switch  from 
the  default  which  capitalizes  everything  to  a  different  mode.  See  also:  force. 

Mode:  Force  (case)  Mode  CASEMODE  OK:  CASEMODE  =  Upper  or  Lower  or  First  (letter 
upper).  With  the  Force  (case)  Mode  command  you  may  choose  whether  subsequent  Force 
STRING  and  Force  STRUCTURE  commands  make  all  letters  lower  case,  capitalize  all  letters, 
or  capitalize  only  the  first  letter  of  every  word. 

Effects:  The  Force  case  STRING  and  Force  case  STRUCTURE  commands  will  work  in 
the  CASEMODE  you  choose  here  (unless  they’re  overridden  with  the  optional  temporary 
CASEMODE  in  that  command)  until  this  command  or  Reset  Case  mode  is  used  again. 

CASEMODE:  Upper,  Lower,  or  First  (letter  upper):  Upper  sets  all  alphabetic  characters  to 
upper  case.  Lower  sets  all  alphabetic  characters  to  lower  case.  First  (letter  upper)  sets 
the  first  alphabetic  character  only  of  all  words  to  uppercase.  [Side-effect:  if  you  Force 
Text  in  First  letter  upper  and  the  text  starts  in  the  middle  of  a  word,  the  first  character 
of  the  text  (in  the  word  it  begins  in)  will  be  capitalized.]  See  also:  Word. 

See  also:  Force,  Reset  Case. 

STRING:  Force  (Case)  STRING  (at)  DESTINATION  [CASEMODE]  OK:  CASEMODE  = 
Upper  or  Lower  or  First  (letter  upper) 

This  group  of  Force  case  commands  changes  the  case  of  characters  in  the  chosen  STRING 
according  to  the  case  mode  currently  in  effect. 

Effects:  The  mode  has  been  set  by  default  to  "upper"  (all  characters  capitalized),  or  by  the 
user  with  the  Reset  Case  Mode  command  (to  Upper)  or  Force  case  Mode  command  (to 
Upper  or  Lower  or  First  letter  upper).  The  most  recently  set  mode  determines  the  result 
of  this  command  unless  you  use  the  [CASEMODE]  option  to  temporarily  override  it. 
You  can  also  change  the  case  of  letters  in  a  whole  statement  or  branch,  etc.,  with  the 
Force  case  STRUCTURE  commands. 

[  CASEMODE  ] :  precede  by  the  OPTION  character  <CTRL-U  >  :  See  casemode. 

%  See  also  Face=5  Force  Mode,  Reset  Case,  Force  STRUCTURE. 

STRING:  Character,  Text,  Word,  Visible,  Invisible,  Number,  or  Link.  See  string. 

STRUCTURE:  Force  (Case)  STRUCTURE  (at)  DESTINATION  [CASEMODE]  OK: 

CASEMODE  =  Upper  or  Lower  or  First  (letter  upper) 

This  group  of  Force  case  commands  changes  the  case  of  characters  in  the  chosen  STRUCTURE 
according  to  the  case  mode  currently  in  effect. 

Effects:  The  mode  has  been  set  by  default  to  "upper"  (all  characters  capitalized),  or  by  the 
user  with  the  Reset  Case  Mode  command  (to  Upper)  or  Force  case  Mode  command  (to 
Upper  or  Lower  or  First  letter  upper).  The  most  recently  set  mode  determines  the  result 
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of  this  command  unless  you  use  the  [CASEMODE]  option  to  temporarily  override  it. 
You  can  also  set  the  case  of  parts  of  statements  with  the  Set  Case  STRING  commands. 

[  CASEMODE  ] :  precede  by  the  OPTION  character  <CTRL-U  >  :  See  casemode. 

See  also:  Force  Mode,  Reset  Case,  Force  STRING. 

STRUCTURE:  Statement,  Branch,  Plex,  or  Group:  See  structure. 


form: 

form  feed--a  special  character  used  in  printing:  See  formfeed. 

formatting- -NLS  conventions  for  arranging  a  page:  See  format. 

format  conventions:  the  way  NLS  arranges  a  printed  page  unless  the  user 
specifies  otherwise.  By  default,  when  you  print  using  the  output  command,  or  the 
TNLS  command  "Print",  NLS  formats  your  output  into  pages  with  text  65 
characters  wide,  and  55  lines  high,  with  statements  indented  3  spaces  for  each 
level  and  certain  other  conventions.  Directives  may  reset  these  values  in  the 
Output  Printer  Command.  The  Useroptions  subsystem  will  reset  them  in  Output 
Quickprint  and  Print  commands.  The  user-subsystem  "Format"  helps  format 
files  for  the  Output  Printer  command.  See  also:  formatting,  Format 
(CALCULATOR). 

directives:  See  directives. 

Format  user-subsystem:  See  format. 

Output  Processor:  See  output. 

Output  Quickprint:  See  quickprint. 

Print  command:  See  print. 

Useroptions  subsystem:  See  useroptions. 

Format:  The  Calculator  subsystem  command  "Format"  allows  you  to  specify  the 
format  of  numbers  stored  in  your  Calculator  file  and  accumulator  values  stored  in 
other  NLS  files.  The  default  number  format  is  right-justification,  2  digits  to  right 
of  the  decimal  and  up  to  9  on  the  left,  no  commas,  and  no  dollar  sign.  See  also: 
file  (CALCULATOR). 

Commas:  Format  Commas  ANSWER  OK:  If  you  type  y  or  CA  for  "Yes"  commas  will  be 
placed  as  so:  999,999,999.9999.  If  you  type  n  for  "No",  no  comma  will  be  inserted. 

Dollar:  Format  Dollar  (signs)  ANSWER  OK:  If  you  type  y  or  CA  for  "Yes',  dollar  signs  $  will 
be  placed  in  front  of  each  number.  If  you  type  n  for  "No",  they  will  not  be  inserted. 

Left:  Format  Left  (justify)  OK:  After  using  this  command,  numbers  will  appear  with  no  spaces 
preceding  them.  See  also:  Right  (CALCULATOR). 

Places:  Format  Places  (to  the)  Right/Left  CONTENT  OK:  The  total  number  of  printing  digits 
allowed  in  a  number  is  11.  Within  this  limit  only  5  can  follow  the  decimal.  If  the  user 
attempts  to  enter  a  number  containing  more  digits  to  the  left  of  the  decimal  point  than  the 
current  format  specifies  or,  if  the  current  accumulator  rises  above  the  current  format 
specification,  an  error  message  is  printed,  the  operation  is  not  performed,  and  the  Places  is 
changed  back  to  the  default  of  two  following  the  decimal. 


Right:  Format  Right  (justify)  OK:  After  using  this  command,  numbers  will  appear  with  enough 
spaces  precedeing  them  for  billions  in  places.  See  also:  Left  (CALCULATOR). 
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Format:  The  user-subsystem  "Format"  provides  tools  to  help  you  work  with 

Output  Processor  directives.  See  the  "Output  Processor  Users  Guide"  available 
by  request  to  FEEDBACK  for  a  complete  listing  of  directives.  Format  contains 
the  following  commands.  See  also:  output,  directives. 

Delete  (directives  in)  STRUCTURE  (at)  DESTINATION  OK:  The  Format  user-subsystem 
command  "Delete"  removes  all  of  the  Output  Processor  directives  in  the  STRUCTURE  you 
specify. 

Delimiters  alternative:  If  you  previously  changed  them:  If  directives  in  the  structure  you 
are  working  on  use  delimiters  other  than  period  and  semicolon  because  you  had  changed 
the  delimiters  in  a  statement  preceding  the  specified  structure,  (e.g.:  DLD  =  ...  DRD=  ...) 
you  must  type  the  "Delimiters"  commandword  before  you  type  OK. 

Delete  (directives  in)  STRUCTURE  (at)  DESTINATION  Delimiters  (left)  CONTENT 
(right)  CONTENT  OK 

Typein  or  point  to  the  characters  which  you  wish  the  system  to  search  for  as  left  and  right 
directive  delimiters.  If  the  delimiters  are  changed  in  the  file,  the  program  will  understand 
and  search  for  the  new  delimiters. 

Insert  Format  (at)  DESTINATION  (using  Format  #)  CONTENT:  (Title:)  CONTENT 

(Author  Ident(s):)  CONTENT 

(Journal  Number:)  CONTENT  (Formatting  File) 

>  The  Format  user-subsystem  command  "Insert"  adds  directives  and  any  necessary  special 
characters  to  a  file  according  to  a  given  predesigned  format.  You  must  first  point  to  the  file. 
It  then  lists  your  choice  of  formats.  Printed  Samples  of  all  the  formats  are  available  through 
FEEDBACK.  You  type  the  number  of  the  desired  format. 

Effects:  Unless  the  file  to  be  formatted  is  a  Journal  file,  it  asks  you  to  type  the  title  of  the 
document,  a  list  of  author  idents  (which  may  include  organization  and  group  idents),  and 
finally  the  Journal  number  (in  case  you  have  a  preassigned  number  that  you  wish  put  on 
the  file).  To  skip  any  of  these  fields  in  TNLS  type  CA,  in  DNLS  type  <CTRL-N  >  .  The 
command  will  insert  the  directives  necessary  to  produce  the  format  you  chose.  It  may 
insert  directives  in  the  origin  statement,  in  every  level  one  statement,  and  in  some  cases 
in  the  statement  back  from  every  level  one  statement.  It  also  creates  a  title  page  as  the 
last  level-one  branch  in  the  file.  The  title,  authors,  and  Journal  number  appear  in  the 
title  page  and  in  some  cases  in  header  or  footer  directives  in  the  origin  statement. 

modifying  the  formatted  file:  The  program  only  inserts  text  in  the  file.  You  may 
edit  any  of  it  as  you  see  fit.  For  example,  if  one  of  the  authors  does  not  have  an 
ident,  you  may  add  his/her  name  to  the  title  page  afterwards.  Or  you  may  edit  the 
directives  to  modify  the  format.  (You  should  feel  fairly  confident  of  your 
understanding  of  the  Output  Processor  before  you  attempt  to  edit  the  more 
complex  of  these  formats!)  See  directives. 

Formats  designed  for  COM:  Most  of  the  formats  were  designed  for  Computer  Output  to 
Microfilm  (COM).  The  intent  is  to  make  it  very  easy  for  users  less  experienced  with  the 
Output  Processor  to  take  advantage  of  COM’s  capabilities. 

How  to  have  your  format  and  read  it  too!:  To  be  safe  you  should  use  the  "Format" 
command  on  files  which  previously  have  no  directives  in  them.  Since  directives  can  get 
in  the  way  of  online  reading,  you  may  want  to: 

-Update  File 

-Execute  (command  in)  Format  Insert  Format 

-Output  COM  or  Output  Printer 

-Delete  Modifications 

This  last  command  undoes  what  the  Insert  Format  command  did.  You  are  then  left  with  a 
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clean  file.  You  must  repeat  the  "Insert  Format"  command  to  prepare  it  for  "Output"  a 
second  time.  See  output  printer  file. 

Set  Directive  (Filter)  OK:  The  Format  user-subsystem  command  "Set  Directive"  sets  your 
current  content-analyzer  filter  to  one  which  only  shows  statements  with  Output  Processor 
directives  in  them.  You  may  then  use  viewspec  i  to  turn  the  filter  on,  and  viewspec  j  to  turn  it 
off  (show  everything). 

Delimiters  alternative:  If  directives  in  the  file  you  are  working  on  use  delimiters  other 
than  period  and  semicolon  (because  you  changed  the  delimiters  in  a  preceeding 
statement),  you  must  use  the  command: 

Set  Directive  (Filter)  Delimiters  (Left)  CONTENT  (Right)  CONTENT  OK: 

Typein  or  point  to  the  left  and  right  directive  delimiter  characters  which  you  wish  the 
program  to  use.  Each  new  view  of  the  file  (a  Jump  or  Print)  through  this  filter  begins 
with  the  assumption  that  the  directive  delimiters  are  these  new  characters.  Changes  in 
the  delimiters  by  subsequent  directives  in  the  view,  will  not  keep  them  from  being  viewed. 

Reset  Directive  (filter)  OK:  The  Format  user-subsystem  command  "Reset  Directive"  sets  your 
current  content-analyzer  filter  to  what  it  was  before  the  Set  Directive  (filter)  command.  This 
only  works  for  one  window  in  DNLS  (be  careful  if  you  have  inserted  an  edge  to  split  your 
window). 

formatting  viewspecs:  change  layout:  y,  z,  A,  B,  g,  1,  h,  m,  n,  C,  D,  G,  H,  I,  J, 
K,  L  .  Compare  hardcopy  format. 

y  viewspec:  blank  line  between  statement  on  See  y. 

Z  viewspec:  blank  line  between  statement  off  Seez. 

g  viewspec:  show  branch  only  See  g. 

I  viewspec:  show  plex  only  Seel. 

h  viewspec:  show  all  branches  Seeh. 

m  viewspec:  statement  numbers/SIDs  on  Seem. 

n  viewspec:  statement  numbers/SIDs  off  Seen. 

A  viewspec:  level  indenting  on  See  A  Viewspec. 

B  viewspec:  level  indenting  off  See  B  Viewspec. 

C  viewspec:  show  statement  names  See  C  Viewspec. 

D  viewspec:  don’t  show  statement  names  See  D  Viewspec. 

E  viewspec:  paginate  when  printing  (TNLS  only)  See  E  Viewspec. 

F  viewspec:  TNLS:  no  paging/DNLS:  recreate  display  See  F  Viewspec. 

G  viewspec:  statement  numbers/SIDs  right  See  G  Viewspec. 

H  viewspec:  statement  numbers/SIDs  left  See  H  Viewspec. 

I  viewspec:  show  SIDs,  not  statement  numbers  Seel  Viewspec. 

J  viewspec:  show  statement  numbers,  not  SIDs  See  J  Viewspec. 

K  viewspec:  statement  signatures  on  See  K  Viewspec. 

L  viewspec:  statement  signatures  off  See  L  Viewspec. 

formfeed:  a  special  character  that  causes  the  equivalent  of  a  printing  device  to 
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position  the  first  character  after  the  form  feed  character  to  be  at  the  top  of  a  new 
page.  The  character  <CTRL-L>  is  often  used  as  the  special  form  feed  character. 

Forward  (item  number)  CONTENT  (for)  ACT/INFO  (only  to)  CONTENT 
OK: 

The  Sendmail  subsystem  command  "Forward"  allows  you  to  re-send  a  journal 
item  with  the  NUMBER  you  specify  for  the  first  CONTENT  to  the  IDENTS  you 
specify  for  the  second  CONTENT.  ACT/INFO  wants  either  the 
Command-Word  Action  or  Information.  See  also:  number  (SENDMAIL). 

The  Send  command:  5eesend. 

.fr  file  return:  an  address  element  that  allows  access  to  a  previous  file  in  your 
file  return  ring.  A  ".fr"  means  the  same  as  Jump  to  File  Return.  A  ".fr"  in  an 
ADDRESS  moves  you  back  through  the  ring.  You  can  precede  the  f  with  a 
number  to  jump  back  more  than  one  position.  EXAMPLE:  the  element  ,2fr 
moves  back  2  positions  (from  the  current  one)  in  the  file  return  ring.  The  final 
viewspecs  in  effect  there  are  also  restored.  Try  this  after  commanding  "Jump". 
See  also:  VIEWSPECS. 

Effects:  to  copy  a  branch  from  the  last  file  you  had  loaded  to  your  presently  loaded  file,  use  fr 
in  the  SOURCE  part  of  the  Copy  command. 

Freeze  Statement  (at)  DESTINATION  VIEWSPECS  OK:  The  DNLS 
command  "Freeze"  keeps  the  statement  at  the  DESTINATION  you  specify  on 
the  upper  part  of  the  screen  (when  viewspec  o  is  on).  You  may  continue  to  use 
other  NLS  commands  in  the  lower  part  of  your  screen.  The  VIEWSPECS  field 
in  this  command  wants  formatting  viewspecs  to  define  the  format  of  the  frozen 
statement.  It  does  NOT  allow  turning  viewspec  o  on;  you  must  do  that 
separately.  If  you  freeze  more  than  one  statement,  they  all  will  show  when  you 
turn  viewspec  o  on.  The  Release  command  "thaws"  frozen  statements.  See  also: 
o,  Release,  DISPLAY-CONTROL.  Compare  SPLIT: 

frontend:  part  of  a  software  system  the  user  interacts  with.  It  dispatches  the  users' 
requests  to  the  appropriate  backend  tool. 
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g  ViewspeC:  show  branch  only:  "Show  only  the  branch  of  the  statement  you  are 
at."  Only  the  addressed  branch  will  appear.  In  TNLS,  this  affects  the  operation 
of  Output  and  Print  commands.  Viewspec  h  does  NOT  limit  operation  to  one 
branch.  To  show  one  plex  only,  use  1. 

G  Viewspec:  statement  numbers/SIDs  right:  "Place  statement  identification  at 
the  right  margin."  If  viewspec  m  is  on,  and  you  turn  G  on,  whichever  type  of 
identification  is  currently  on  (viewspec  I-SIDs  or  J-statement  numbers)  will 
appear  at  the  right  margin  after  each  statement.  Viewspec  H  turns  G  off  and 
shows  identification  at  the  left  of  statements.  Example:  the  string  mGJ  will  show 
statement  numbers  at  the  right  margin.  See  also:  Statementnumber,  SIDs,  m, 
Capital-1,  Capital  — J,  Capital-H. 

Getting  a  number:  Using  Sendmail’s  Reserve  command  gets  you  a  preassigned 
number,  which  can  then  be  used  at  a  later  time.  Using  the  Number  command 
gets  you  the  number  for  the  item  you  are  currently  sending  in  the  Sendmail 
Subsystem.  See  also:  number  (SENDMAIL),  reserve  (SENDMAIL). 

Getting  Help:  1)  strike  ?  at  any  point  in  an  NLS  command  for  a  list  of  alternatives 
currently  available  to  you. 

>  2)  hold  down  the  <CTRL>  button  and  hit  q,  at  any  point,  for  an  explanation  of 
your  current  alternatives. 

Method  2  puts  you  into  the  Help  command  repeat  mode  until  you  hit  CD 
(Command  Delete  <CTRL-X>)  See  also:  help. 

questionmark:  See  questionmark. 

<CTRL-Q>:  See  <CTRL  Q>  . 

Getting  just  the  syntax  of  a  command  <CTRL-S>:  If  you  hold  down  the  CTRL  key  and 
type  s,  you  will  get  the  command  syntax  for  the  command  which  you  are  currently  using. 

When  help  fails:  Novices  should  feel  free  to  connect  to  experienced  users  and  ask  questions. 
Keeney,  Kelley,  van  Nouhuys,  Beck,  and  Bair  are  particularly  open  to  connecting.  Also, 
sendmail  to  ident  FEEDBACK  and  explain  what  went  wrong. 

connecting:  See  connecting. 

sending  mail:  See  sendmail. 

Goto  (subsystem)  SUBSYSTEM  OK:  The  command  "Goto"  puts  you  into  a 
different  subsystem  where  you  can  proceed  to  specify  commands  in  that 
subsystem.  After  the  OK,  you  will  get  the  herald  of  the  new  subsystem.  The 
Goto  commands  adds  the  subsystem  to  your  subsystem  stack.  If  you  only  want 
to  execute  one  command  in  another  subsystem,  use  the  Execute  command.  The 
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Quit  command  takes  you  back  in  turn  to  each  previous  subsystem.  You  can  use 
the  "Quit  To"  command  to  specify  a  specific  subsystem  in  your  stack  that  you 
want  to  return  to.  See  SUBSYSTEM . 

TNLS  example: 

BASE  C:  Goto  (subsystem)  C:  Programs  OK: 

PROG  C: 

grammar:  a  tree  structured  data  structure  that  represents  allowed  user  interactions. 
See  CML. 

Graphic:  a  picture  drawn  using  the  marking  capabilities  of  a  work-station. 

greaterthan  symbol:  >  current  subsystem.  See  also:  SUBSYSTEM, 

anglebrackets. 

Group  (from)  SOURCE  OK:  The  sendmail  subsystem  command  "Group" 
allows  you  to  send  a  Group  of  branches  or  statements.  Specify  the  Group  to  be 
mailed  by  pointing  to  the  first  and  last  statement  for  SOURCE.  VIEWSPECS  do 
not  matter. 

Definition  of  a  Group:  See  group. 

GROUP-IDENT:  A  group  IDENT  is  a  shorthand  way  of  specifying  many  users' 
IDENTS.  Several  users  who  are  working  together  may  form  a  group  that  has  one 
single  IDENT.  Messages  sent  to  the  GROUP-IDENT  will  then  go  to  all  the 
members. 

Group:  a  series  of  consecutive  statements  (including  all  their  substructure)  at  the 
same  level.  In  the  illustration,  the  group  defined  by  3b  and  3c  consists  of 
branches  3b  and  3c  (i.e.,  statements  3b,  3c,  3c  1,  and  3c la).  After  pointing  to  the 
beginning  of  a  group,  an  ADDRESS  is  needed  to  point  to  the  end  of  the  group. 

Group-Text:  pointing:  Two  points  are  required  to  specify  a  group  or  a  text,  one  at  its  beginning 
and  another  at  its  end.  After  the  first  point  has  been  specified  NLS  will  expect  the  second.  If 
you  make  a  mistake,  you  will  be  told  "invalid  text  selection"  or  "illegal  group"  and  you  must 
respecify  the  points.  See  also:  pointing,  group,  text. 

illustration  of  file  structure:  See  illustration. 
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h  ViewspeC:  show  all  branches:  "Show  all  branches."  Normally,  when  you  Print 
or  Output  a  file,  or  display  something  in  DNLS,  all  branches  of  the  file  appear. 
Viewspec  h  is  used  to  turn  off  viewspec  g  (show  branch  only)  and  1  (show  plex 
only).  This  is  a  default  viewspec. 

H  Viewspec:  statement  numbers/SIDs  left:  "Place  statement  identification  at  the 
left  of  each  statement."  This  viewspec  takes  effect  when  viewspec  m  is  on. 
Whichever  type  of  identification  is  currently  on  (I-SIDs  or  J-statement  numbers) 
will  appear  at  the  beginning  of  each  statement.  Example:  if  you  have  SIDs  on  at 
the  right  and  want  to  change  to  statement  numbers  at  the  left,  use  the  string  HJ. 
This  is  a  default  viewspec.  See  also:  Statementnumber,  SIDs,  m,  Capital -I, 
Capital- J,  Capital-G. 

Handbook:  A  complete  reference  work  of  all  systems  and  activity  at  the 

Augmentation  Research  Center  at  a  given  time. 

handling  whole  files:  NLS  provides  many  commands  that  deal  with  whole  files 
allowing  you  to  make  changes,  erase  changes  made,  send  files  to  people,  delete 
them,  and  transfer  files  from  one  directory  or  site  to  another,  and  return  to  recent 
files  you  have  accessed. 

creating  files:  See  create. 

return  ring  among  files:  See  file- return. 

status:  The  Show  File  Status  command  See  status. 

name:  Fileaddressing:  See  fileaddress. 

modification  file:  See  modification. 

commands:  list  of  Base  file-handling  commands:  See  file-handling. 

Hardcopy  printing  and  formatting:  You  may  print  your  NLS  files  at  your 
terminal,  at  a  line  printer  at  ARC,  at  a  printer  at  your  site  if  it  is  available,  or 
through  COM  (Computer  Output  to  Microfilm).  COM  offers  offset  with  graphic 
arts  quality  type.  A  set  of  directives  you  put  in  your  text  allows  you  to  design 
various  formats.  See  also:  offline  (SENDMAIL). 

printing  on  your  terminal:  See  printing. 

printer:  printing  on  your  computer’s  line  printer  See  printer. 

format  conventions:  See  format. 

publish  subsystem:  See  publish  (PROGRAMS). 

format  subsystem:  See  format  (PROGRAMS). 
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Hardware: 

IMP:  acronym  for  Interface  Message  Processor  ...  SaHMP. 

Multiline  Controller:  See  Multiline. 

TIP:  Terminal  IMP  5eeTIP. 

Hardware:  machinery.  That  which  transmits  or  stores  information  as  opposed  to 
software  which  is  the  information  transmitted  or  stored.  See  also:  software, 
terminals. 

Computers:  See  site. 

Network:  See  hardware. 

head:  The  first  statement  at  the  same  level  as  the  statement  you  specify.  In  the 
illustration,  statement  1  is  the  head  of  statements  1,  2,  and  3;  la  is  the  head  of  lb 
and  la.  The  origin  statement  is  its  own  head.  The  "head"  is  the  first  statement 
in  a  plex.  Compare:  tail.  See  also:  source,  illustration,  origin. 

header:  The  text  that  is  automatically  created  at  the  beginning  of  each  recorded 
item  sent  via  Sendmail.  This  header  contains  the  SENDLIST,  the  AccessList  (if 
any),  and  many  output  processor  directives  followed  by  the  Origin  Statement  of 
the  source  if  the  item  was  an  entire  file.  See  also:  List,  statement. 

header:  See  header  (SENDMAIL). 

Getting  Help:  1)  Strike  ?  at  any  point  in  an  NLS  command  for  a  list  of 
alternatives  currently  available  to  you.  2)  Hold  down  the  <CTRL>  button  and 
hit  q,  at  any  point,  for  an  explanation  of  your  current  alternatives.  Note: 
Method  2  puts  you  into  the  Help  command  repeat  mode  until  you  hit  CD 
(Command  Delete  <CTRL-X  ).  Set?  dlso .  h©!pa 

Help  TYPEIN/OK:  The  command  "Help"  provides  the  most  complete 

information  about  all  aspects  of  NLS.  After  you  type  in  (TYPEIN)  any  term  and 
hit  the  Command  Accept  (CA)  key  (<CTRL~D>),  you  will  see  the  description 
and  the  Help  command  will  be  ready  for  another  TYPEIN.  TYPEIN  any  term 
you  wish  or  the  number  of  a  "menu"  followed  by  CA.  Any  time  after  the  first 
description  prints,  you  can  type  —  followed  by  y  (for  yes)  to  see  the  previous  view 
indicated  or  n  (for  no)  to  choose  a  view  before  that.  Hit  the  Command  Delete 
(CD)  key  <CTRL-X>  to  end  the  Help  command. 

menu:  A  numbered  list  of  related  subjects  that  may  follow  an  explanation  in  the  Help  command. 
This  list  is  called  a  menu.  Typing  a  number  followed  by  <CA>  will  show  the  explanation 
named. 

commands:  how  to  see  command  descriptions:  After  a  command  verb  type  <CTRL-S>  for  a 
short  description  or  <CTRL-Q>  for  a  longer  description. 

In  the  Help  command,  to  get  the  description  for  any  Base  command,  type  the  verb.  For  example, 
type:  Set  <CA>  for  a  description  of  the  command  Set. 

To  see  the  description  of  any  command  not  in  the  BASE  subsystem,  precede  the  commandword(s) 
with  the  name  of  the  SUBSYSTEM.  For  example,  in  the  Help  command,  type:  Sendmail 
Interrogate  <CA>  for  a  description  of  the  command  Interrogate  in  the  Sendmail  subsystem. 

To  see  all  of  the  commands  in  any  subsystem,  type  the  SUBSYSTEM  name  followed  by  the  word 
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"commands".  For  example,  type:  Base  commands. 

Capitalization  does  not  matter  when  using  words  in  the  Help  command. 

uparrow:  T  going  up  (for  advanced  users):  if  you  use  t  instead  of  —  ,  you  will  go  "up”  instead 
of  "back".  Going  up  lets  you  "see  your  surroundings."  Because  of  the  "random  access" 
nature  of  Help,  it  is  sometimes  the  same  but  can  be  quite  different  from  going  back.  This  is 
just  a  convenience,  it  is  not  necessary  for  using  the  Help  command. 

getting  help  in  NLS:  See  NLS. 

How  to  use  NLS:  See  NLS. 

TNLS  example: 

BASE  C:  Help  OK/1: 

BASE  subsystem: 

The  BASE  subsystem  is  the  major  subsystem  of  NLS.  It  has  commands  that  allow  you  to 
name,  read,  and  write  information  online  and  output  it  to  hardcopy.  When  you  enter  NLS, 
you  begin  in  the  BASE  subsystem. 

1  .  How  to  use  the  BASE  subsystem 

2.  commands  in  the  BASE  subsystem: 

(Help)  «-/T:  T:  T 

NLS:  Online  System 

NLS  is  a  system  for  using  computers  to  help  in  knowledge  work  based  on  textual  information. 
With  NLS  you  may  read,  write,  publish,  mail,  collaborate,  calculate,  and  program,  among 
other  things,  in  an  integrated  way  augmented  by  the  computer.  The  command  language 
allows  moving  around  in  and  modifying  the  information  hierarchy.  NLS  groups  commands 
into  subsystems  for  related  tasks.  To  find  out  how  to  do  a  task  in  NLS,  see:  HOW 

(Help)  -/T: 

TNLS  peculiarities:  Typing  <CTRL-0>  will  stop  the  current  process.  This  will  have  bad 
side-effects  especially  the  first  time  using  the  Help  command  until  this  bug  is  fixed.  To  skip 
the  introductory  message  each  time  and  go  directly  to  the  subject  you  are  looking  for,  type  the 
word  in  the  Help  command  the  first  time  before  hitting  CA.  After  you  start  to  type  something 
in  the  Help  command,  the  prompt  T/[A]:  will  appear.  Please  ignore  it.  See  also:  < 
CTRL-0>,  prompt. 

emergencies:  In  the  case  of  system  error  messages  type  <  CTRL-C  >  (hold  down  the  CTRL  key 
and  hit  c).  When  you  see  the  at-sign  @  type  "NLS"  and  a  carriage  return.  This  should 
totally  clean  everything  out  and  start  over  in  NLS.  See  also:  BAD,  <CTRL-0>  ,  <CTRL-X>  , 
<  CTRL-C  >. 

heralds:  The  identifying  character(s)  each  SUBSYSTEM  prints  at  the  left  margin 
for  each  command  when  you  use  NLS  through  teletype-like  terminals.  The 
herald  is  usually  the  first  few  letters  of  the  subsystem’s  name.  You  may  adjust 
the  length  of  these  heralds,  or  have  only  a  star  *  print  at  the  margin  for  every 
subsystem,  in  the  Useroptions  subsystem. 

Herald  [  affects  TNLS  only  ] :  HERALDSPECS  OK:  The  Useroptions  subsystem  command 
"Herald"  allows  you  to  specify  the  number  of  characters  of  each  subsystem  name  that  will 
print  as  a  TNLS  herald,  or  to  choose  to  have  a  star  *  print  as  the  herald  for  every  subsystem. 
See  also:  heralds,  subsystem. 

HERALDSPECS:  Terse,  Verbose,  Length:  for  HERALDSPECS,  you  may  choose  terse 
which  makes  the  herald  for  every  subsystem  a  star  *.  Verbose  (the  default)  which  makes 
the  herald  the  first  few  characters  of  the  current  subsystem  name.  If  Length  is  left  to 
default,  four  letters  (such  as  BASE  when  in  USEROPTIONS)  will  print.  For  Length, 
you  may  specify  the  number  of  letters  of  the  name  to  be  printed  when  Verbose  is  the 
chosen  HERALDSPECS. 
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See  also  these  related  commands:  Useroptions  Reset  Herald,  Useroptions  Show  Herald. 

Useroptions  Herald  command:  See  herald  (USEROPTIONS). 

exception  for  TENEX  as  a  subsystem  of  NLS:  TENEXs  herald  is  always  atsign  @ 

heralds  in  DNLS:  in  DNLS,  the  herald  or  the  name  of  your  current  subsystem  shows  in  the 
upper  left  corner  of  the  display. 

hierarchy:  See  file. 

Host  Site:  See  server. 

How  to  use  NLS:  you  use  NLS  by  typing  in  commands.  Commands  begin  with 
verbs  such  as  "Insert"  or  "Substitute",  or  "Delete".  Commands  tell  the 
computer  what  you  want  to  do.  With  commands,  you  can  locate,  transform,  or 
disseminate  text  from  the  computer.  To  use  NLS,  you  must  understand 
commanding.  See  also:  NLS. 

Systems:  entering  and  leaving  See  Systems. 

Getting  Help:  See  Getting. 

Commanding:  See  command. 

Pointing  to  information:  addressing  and  bugging  See  Pointing. 

Reading  and  viewing  information:  See  Reading. 

Writing,  creating  and  modifying  information:  See  Writing. 

Hardcopy  printing  and  formatting:  See  Hardcopy. 

Profile  defining:  the  useroptions  subsystem:  See  useroptions. 

Programming  for  users:  Preprograms. 


62 


NLS-8 


I 


I 


i  ViewspeC:  analyze  the  content  of  statements:  "Show  only  those  statements  that 
satisfy  the  content-analyzer."  If  you  have  specified  a  content-analyzer  and  have 
viewspec  i  on,  every  statement  is  checked  for  the  pattern;  if  it  passes  you  will  be 
able  to  view  or  edit  it.  Viewspec  j  turns  the  content-analyzer  off.  If  there  is  no 
content-analyzer  written,  compiled,  loaded,  and  instituted,  viewpec  i  has  no  effect. 
Viewpecs  i,  j,  and  k  are  mutually  exclusive.  You  can  turn  on  viewspec  i  using  the 
BASE  subsystem  command  "Set  Content  (pattern)  On". 

I  Viewspec:  show  SIDs,  not  statement  numbers:  "Use  SIDs  for  statement 
identification."  If  viewspec  m  is  on,  turning  I  on  will  show  each  statement’s  SID. 
Viewspec  J  shows  statement  numbers  instead.  The  viewspecs  G  (right  margin) 
and  H  (left  of  statement)  determine  where  the  statement  numbers  will  appear. 
Example:  the  string  mIG  will  make  SIDs  appear  at  the  right  margin  after  each 
statement.  See  also:  Statementnumber,  SID,  m,  Capital- J,  Capital-H,  Capital-G. 

id:  See  ident. 

IDENT:  a  string  of  2-5  characters  that  identifies  you  to  NLS  and  is  recorded  with 
your  address  in  a  master  file.  It  is  often  your  initials  and  can  be  the  same  as  your 
TENEX  password,  but  they  are  keys  to  different  systems.  IDENTS  designate 
Journal  authorship  and  distribution.  Whenever  an  IDENT  is  expected  in  a 
command,  and  you  don’t  know  the  IDENT,  you  can  use  one  of  the  following. 

See  also:  initial. 

last-name  search:  .lastname,  .last...  See  last-name. 

content  search:  "TYPEIN":  See  content. 

GROUP-IDENT:  See  GROUP-IDENT. 

IDENTLIST:  See  IDENTLIST. 

If  you  have  no  ident  or  if  your  ident  information  needs  updating,  send  your  request  via  sendmail  or 
sndmsg  to  the  IDENT  or  USERNAME  FEEDBACK  (at  office- 1).  See  also:  show  record 
(SENDMAIL). 

Identification  subsystem:  This  is  a  protected  subsystem  for  which  there  is  no 
Help  description.  To  enter  or  modify  any  IDENT  information,  sndmsg  or 
sendmail  to  FEEDBACK  describing  your  modification.  Use  the  Sendmail 
subsystem's  Show  Record  (for  ident)  command  to  see  address,  phone,  etc.. 

Sendmail’s  show  record  command:  5eeshow  record  (SENDMAIL). 

IDENTLIST:  a  list  of  IDENTS  separated  by  commas.  In  Sendmail  distributions,  an 
IDENT  may  be  immediately  followed  (no  spaces)  by  a  parenthetical  comment 
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which  will  only  go  to  that  IDENT.  i.e.,  IDENT(comment).  The  parenthetical 
comment  may  not  include  a  period. 

The  distribute  command:  See  distribute  (SENDMAIL). 

IDENTS:  See  identlist. 

illustration  of  file  structure: 

0  ... 

1  ... 
la  ... 
lb  ... 

lbl  ... 

Ib2  ... 

Ib3  ... 

2  ... 

3  ... 

3a  ... 

3b  ... 

3c  ... 

3c  1  ... 

3cla  ... 

NOTE:  Each  group  of  3  dots  above  represents  a  statement  in  the  structure  of  the 
file.  The  statement  numbers  (e.g.,  "lbl"  and  its  following  space)  are  not  part  of 
the  statement;  they  serve  only  to  identify  the  location  of  the  statement. 

File:  Seefile. 

IMLAC:  The  manufacturer  of  a  display  console  used  experimentally  with  NLS. 

IMP:  acronym  for  Interface  Message  Processor  -  A  specially  modified  Honeywell 
316  or  516  processor  which  serves  as  the  communications  computer  in  the 
ARPANET.  See  BBN  (for  documentation). 

Include  Subsystem/Program  ....  :  The  Useroptions  subsystem  command 
"Include"  allows  you  to  choose  what  subsystems  or  programs  are  automatically 
available  to  you  when  you  enter  NLS.  The  programs  directory  contains  standard 
NLS  user  programs.  It  does  not  take  effect  until  you  re-enter  NLS  anew.  Use 
the  useroptions'  "Exclude"  command  to  delete  subsystems  and  programs  from 
your  list  of  inclusions.  Use  the  useroptions’  Show  Default  command  to  see  your 
current  default  subsystem  and  program  status.  See  also:  Entry  (USEROPTIONS). 

syntax- 

Include  Subsystem  SUBSYSTEM  OK: 

Include  Program  CONTENT  OK: 

The  USEROPTIONS  Exclude  Subsystem/Program  . . .  command:  See  exclude 
(USEROPTIONS). 

The  USEROPTIONS  Show  Default  (subsystems  and  programs)  command:  See  show 
default  (USEROPTIONS). 

The  USEROPTIONS  Entry  Subsystem/Program  ...  command:  See  entry 

(USEROPTIONS). 

includable  subsystems:  See  attachable. 
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programs  library:  See  library  (PROGRAMS). 

indenting: 

For  level-indenting:  See  level. 

To  control  indenting  of  levels  of  NLS  hierarchical  structure:  See  printoptions  indenting 
(USEROPTIONS). 

To  control  indenting  of  commands  from  left  margin  of  TNLS  printout,  use  the  Useroptions 
Feedback  Indenting  command:  See  feedback  indenting  (USEROPTIONS). 

To  set  tabstops:  See  tab  (USEROPTIONS). 

index:  See  publish  (PROGRAMS), 
indexes:  See  catalogs. 

Inferior  Exec:  [TENEX  as  a  subsystem  of  NLS]:  NLS’s  Goto  TENEX 
command  gives  you  a  second  copy  of  TENEX  (called  "inferior  exec")  identical  in 
most  respects  to  the  copy  you  got  when  you  logged  in.  By  using  the  Goto 
TENEX  command,  you  preserve  your  copy  of  NLS  and  can  return  to  it  if  you 
wish  by  using  the  Exec’s  "Quit"  command.  If  you  Quit  to  TENEX,  you  risk  the 
chance  of  losing  your  copy  of  NLS  when  you  call  another  subsystem  in  TENEX. 
From  inferior  exec  you  may  not  log  out;  from  superior  exec  you  may  not  Quit. 
(From  inferior  exec  you  may  call  a  second  copy  of  NLS,  and  from  it  a  second 
inferior  exec,  and  so  on  if  you  care  to.)  The  programs  command  "Run"  allows 
you  to  use  a  TENEX  subsystem  interactively  from  NLS.  See  also:  Programs, 
Run. 

infile-return:  See  return. 

INFILEADDRESS: 

POSITION:  See  POSITION. 

STRINGPOSITION:  See  STRINGPOSITION . 

SID:  Statement  IDentifier:  See  SID. 

STATEMENTNUMBER:  See  STATEMENTNUMBER. 

STATEMENTNAME:  See  STATEMENTNAME. 

NEXTNAME:  See  NEXTNAME. 

BRANCHNAME:  See  BRANCHNAME. 

EXTERNALNAME:  See  EXTERNALNAME. 

CHARACTERADDRESS:  ’CHARACTER  See  CHARACTERADDRESS. 

CONTENTADDRESS:  See  CONTENTADDRESS. 

MARKER:  See  MARKER. 

slash  /  :  See  Slant =OfT$s! ash. 

backslash  \  :  prints  the  statement  you  are  on  See  backslash . 

Information  hierarchy:  Computers  store  information  on  tape,  and  on  random 
access  devices  called  disks.  Computers  may  also  be  connected  together  in 
networks.  A  Network  TENEX  site’s  computer  (disk)  storage  is  divided  into 
directories,  one  for  each  "user".  Each  directory  may  hold  a  number  of  files. 
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NLS  files  can  be  arranged  in  a  hierarchical  STRUCTURE  of  titles  and 
paragraphs  called  Statements  which  are  made  up  of  character  STRINGS.  Your 
location  in  NLS  information  hierarchy  refers  to  the  character  at  which  you  are 
presently  located. 

Character:  See  character. 

Statement  STRING:  See  Statement. 

File  STRUCTURE:  5eeFile. 

Directory:  See  Directory. 

Site,  Computer:  5eeSite. 

Network:  See  Network. 

initial  (IDENT)  file:  The  file  that  is  automatically  loaded  for  you  when  you  enter 
NLS.  If  you  have  no  initial  file,  NLS  creates  one.  Its  name  is  your  ident.  It 
contains  a  branch  named  "journal"  where  sendmail  citations  are  delivered  to  you 
automatically,  and  a  similar  branch  "author"  where  items  you  send  are  recorded. 
You  may  add  anything  else  to  your  initial  file  (See  also:  writing).  When  you 
first  enter  NLS  you  are  in  the  BASE  subsystem,  and  you  are  at  the  first  character 
of  the  origin  statement  in  your  initial  file.  See:  citation. 

Initialize  (specifications)  OK:  The  Sendmail  subsystem  command  "Initialize 
Item"  resets  all  of  the  Sendmail  commands.  It  places  your  IDENT  as  author 
and  deletes  everything  from  the  other  commands.  Use  this  command  if  you 
receive  error  messages  while  using  Sendmail.  This  is  done  automatically  every 
time  you  enter  the  Sendmail  Subsystem. 

Author:  The  Author  of  a  document  or  message  distributed  via  the  sendmail  subsystem  is  usually 
specified  by  the  IDENT  of  the  person  logged  in  to  distribute  the  mail.  If  you  use 
"Interrogate,"  the  author  will  be  you  unless  you  specify  otherwise.  Other  IDENTs  can  be 
substituted  or  added  with  Sendmail’s  Authors  command.  After  you  have  mailed  an  item  that 
you  authored,  a  citation  to  it  will  appear  in  your  INITIAL  file  under  a  branch  with  the 
STATEMENTNAME  author.  This  is  your  automatic  bibliography  of  all  the  items  you 
"published"  in  the  Journal  via  the  Sendmail  subsystem. 

Sendmail’s  authors  command:  See  authors  (SENDMAIL). 

IDENT:  See  ident. 

Sendmail  commands:  See  sendmail. 

input  is  handled  as  follows:  The  number  is  reformatted  according  to  the 
current  format  specifications.  See  also:  format.  The  number  and  its  operator  (if 
any)  is  entered  into  the  Calculator  file.  The  designated  arithmetic  operation  is 
performed  on  the  value  stored  in  the  accumulator.  The  resulting  calculation 
replaces  the  old  accumulator  value.  The  reformatted  number,  the  operator,  and 
the  new  accumulator  value  are  printed  at  the  terminal. 

Input:  use  the  insert  command.  See  insert. 

Insert:  add,  duplicate,  create  information:  The  command  "Insert"  allows  you  to 
add,  duplicate  or  create  information  in  a  file. 

Character:  Insert  Character  (to  follow)  DESTINATION  CONTENT  OK:  The  command 

"Insert  Character"  adds  the  character(s)  you  specify  for  CONTENT  after  the  character  in  an 
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existing  statement  that  you  point  to  for  the  DESTINATION.  Afterwards,  you  are  located  at 
the  last  character  you  inserted.  See  also:  CONTENT,  DESTINATION,  character,  Insert. 

Date:  Insert  Date  (to  follow)  DESTINATION  OK:  The  command  "Insert  Date"  adds  the 
current  date  into  your  file  after  the  visible  you  point  to  for  the  DESTINATION.  Type 
<  CTRL-T  >  to  see  the  current  date  and  time. 

Edge:  [DNLS  only]  Insert  Edge  (perpendicular  to)  DIRECTION  OK:  The  command  "Insert 
Edge"  divides  your  display  window.  You  may  Bug  the  margin  where  you  want  the  edge  to  be 
or  specify  the  commandword  "Center  (oQ  BUG"  for  DIRECTION.  The  location  of  your 
cursor  when  you  type  OK  determines  which  side  of  the  edge  will  contain  the  information  in 
your  old  window.  All  of  your  file  and  statement  return  memories  are  located  in  your  old 
window.  New  windows  start  over.  The  new  window  will  say  "Empty".  The  Jump  command 
puts  things  in  the  window  containing  the  cursor.  Use  the  Delete  Edge  command  to  get  rid  of 
windows.  Once  an  edge  has  been  deleted,  it  cannot  be  retrieved.  See  also:  Edges,  Window, 
cursor,  Move  Edge,  Delete  Edge. 

Invisible:  Insert  Invisible  (to  follow)  DESTINATION  CONTENT  OK:  The  command  "Insert 
Invisible"  adds  the  character(s)  you  specify  for  CONTENT  after  the  character  in  an  existing 
statement  that  you  point  to  for  the  DESTINATION.  Afterwards,  you  are  located  at  the  last 
character  you  inserted.  See  also:  Invisible,  CONTENT,  DESTINATION,  Character,  Insert. 

Link:  Insert  Link  (to  follow)  DESTINATION  CONTENT  OK:  The  command  "Insert  Link" 
adds  the  characters  you  specify  for  CONTENT  after  the  visible  in  an  existing  statement  that 
you  point  to  for  the  DESTINATION.  Necessary  spaces  and  link  delimiters  (angle-brackets) 
are  added  automatically.  Afterwards,  you  are  located  at  the  last  character  you  inserted. 

Number:  Insert  Number  (to  follow)  DESTINATION  CONTENT  OK:  The  command  "Insert 
Number"  adds  the  character(s)  you  specify  for  CONTENT  after  the  visible  in  an  existing 
statement  that  you  point  to  for  the  DESTINATION.  Necessary  spaces  are  added 
automatically.  Afterwards,  you  are  located  at  the  last  character  you  inserted.  See  also: 
Visible,  CONTENT,  DESTINATION,  Character,  Insert. 

Sendmailform:  Insert  Sendmail  (form  to  follow)  DESTINATION  LEVEL-ADJUST  OK:  The 
command  "Insert  Sendmailform"  inserts  a  form  listing  Sendmail  commands  into  a  file  as  a 
statement.  Use  NLS  text-editing  commands  to  fill  out  this  form.  The  system  fills  in  the 
IDENT  of  the  logged-in  user  for  the  Author,  but  you  may  change  it.  Commands  you  leave 
blank  will  be  ignored.  Use  the  Process  (command  form)  command  in  the  Sendmail 
SUBSYSTEM  to  automatically  execute  the  commands  in  the  form.  After  insertion  you  are  at 
the  first  character  of  the  list  of  commands. 

sendmailforms  for  all  commands:  a  single  STATEMENT  with  a  list  of  sendmail 
commands.  Each  command  ends  with  a  carriage  return  in  the  form  statement  except  the 
SEND  command  which  must  appear  at  the  end  and  be  terminated  by  a  period.  Do  not 
use  a  carriage  return  in  the  text  of  a  MESSAGE  in  the  sendmail  form  as  any  carriage 
return  means  "end  of  the  message".  This  means  you  may  not  use  <  CTRL-V  >  CR  either. 
Any  of  the  following  commands  can  be  in  a  sendmail  form.  Any  commands  misspelled, 
containing  lower  case  letters,  or  not  listed  below  will  be  ignored.  Many  prudent  users 
delete  "SEND"  (but  not  the  preceeding  carriage  return),  and  send  the  item  manually 
after  viewing  it  by  using  the  Show  Status  command  to  check  their  input.  See  also: 
process. 

TITLE:  TYPEIN  a  title:  See  title. 

COMMENT:  See  comment  (SENDMAIL). 

AUTHOR(S):  IDENTLIST:  See  authors  (SENDMAIL). 

NUMBER:  See  number  (SENDMAIL). 

DISTRIBUTE  FOR  ACTION  TO:  IDENTLIST:  See  distribute  (SENDMAIL). 
DISTRIBUTE  FOR  INFO-ONLY  TO:  IDENTLIST:  See  distribute  (SENDMAIL). 
SUBCOLLECTION(S):  IDENTLIST:  See  subcollections  (SENDMAIL). 
KEYWORD(S):  TYPEIN:  See  keywords  (SENDMAIL). 
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HANDLING  INSTRUCTION:  See  expedite  (SENDMAIL). 

RECORDING  INSTRUCTION:  See  unrecorded  (SENDMAIL). 

OFFLINE  ITEM  --  LOCATED  AT:  TYPEIN:  See  offline  (SENDMAIL). 

RFC  NUMBER:  See  RFC  (SENDMAIL). 

OBSOLETES  ITEM  NUMBER(S):  See obsoletes  (SENDMAIL). 

ACCESS  STATUS:  See  private  (SENDMAIL). 

UPDATE  TO  ITEM  NUMBER(S):  See  update  (SENDMAIL). 

INSERT  LINK  TO  FOLLOW:  See  insert  link  (SENDMAIL). 

FORWARD  ITEM  NUMBER:  See  forward  (SENDMAIL). 

MESSAGE:  TYPEIN:  See  message  (SENDMAIL). 

STATEMENT  AT:  <LINK>:  See  statement  (SENDMAIL). 

BRANCH  AT:  <LINK>:  See  branch  (SENDMAIL). 

PLEX  AT:  <  LINK  >  :  See  plex  (SENDMAIL) . 

GROUP  AT:  <  LINK  >  :  See  group  (SENDMAIL) . 

FILE:  <  LINK  > 

SEND  THE  MAIL:  See  SEND. 

Sendmail’s  Process  (command  form)  command:  See  process  (SENDMAIL). 

Sendmail:  See  sendmail . 

DESTINATION:  See  destination. 

LEVEL-ADJUST:  See  level-adjust. 

OK:  See  OK. 

NLS  text-editing  commands:  See  modifying-commands. 

I  DENT:  Seeident. 

Statement:  See  Statement. 

Statement:  Insert  Statement  (to  follow)  DESTINATION  LEVEL-ADJUST  CONTENT  OK: 
The  command  "Insert  Statement"  allows  you  to  create  new  statements  in  your  file.  To 
TYPEIN  many  statements  in  a  row,  use  OKINSERT  <CTRL-E>.  CONTENT  allows  the 
specification  of  a  DESTINATION,  i.e.  you  can  "copy"  an  existing  Statement,  instead  of 
"inserting"  a  new  one,  with  this  command.  After  execution,  you  are  at  first  character  of  the 
newly  inserted  Statement. 

OKINSERT:  See  OKINSERT. 

Text:  Insert  Text  (to  follow)  DESTINATION  CONTENT  OK:  adds  the  character(s)  you  specify 
for  CONTENT  after  the  character  in  an  existing  statement  that  you  point  to  for  the 
DESTINATION.  Afterwards,  you  are  located  at  the  last  character  you  inserted.  See  also: 
Invisible,  Insert  Character. 

Time:  Insert  Time  (and  Date  to  follow)  DESTINATION  OK:  Inserts  the  current  time  and  date 
after  the  character  in  an  existing  statement  that  you  point  to  for  DESTINATION.  To  see  the 
current  time,  type  control-t  <CTRL-T>. 

Visible:  Insert  Visible  (to  follow)  DESTINATION  CONTENT  OK:  adds  the  character(s)  you 
specify  for  CONTENT  after  the  visible  in  an  existing  statement  that  you  point  to  for  the 
DESTINATION.  Necessary  spaces  are  added  automatically.  Afterwards,  you  are  located  at 
the  last  character  you  inserted.  See  also:  Visible,  CONTENT,  DESTINATION,  Character, 
Insert. 
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TNLS  example: 

BASE  C:  Insert  C:  Visible  (to  follow)  A:  03  "9:30" 

T.  p.m. 

BASE  C: 

Word:  Insert  Word  (to  follow)  DESTINATION  CONTENT  OK:  adds  the  character(s)  you 
specify  for  CONTENT  after  the  word  in  an  existing  statement  that  you  point  to  for  the 
DESTINATION.  Necessary  spaces  are  added  automatically.  Afterwards,  you  are  located  at 
the  last  character  you  inserted. 

STRING:  Insert  STRING  (to  follow)  DESTINATION  CONTENT  OK:  This  group  of 

commands  allows  a  new  STRING  to  be  entered  in  an  existing  statement.  See  also:  Substitute. 

Effects:  CONTENT  provides  you  the  choice  of  DESTINATION,  that  is,  you  can  "copy" 
an  existing  STRING,  instead  of  "inserting"  a  new  one,  with  this  command.  After 
execution,  you  are  at  the  last  character  of  the  inserted  text.  If  you  insert  a  link,  NLS 
will  automatically  supply  angle-bracket  delimiters  if  you  do  not  supply  the  delimiters. 
See  also:  link. 

STRING  =  Character,  Text,  Word,  Visible,  Invisible,  Number,  Link:  See  string. 

STRUCTURE:  Insert  STRUCTURE  (to  follow)  DESTINATION  LEVEL-ADJUST  CONTENT 
OK: 

This  group  of  "Insert"  commands  allows  you  to  create  new  statements  in  your  file.  To 
TYPEIN  many  statements  in  a  row,  use  OKINSERT  <  CTRL-E  > .  CONTENT  allows  the 
specification  of  a  DESTINATION,  i.e.,  you  can  "copy"  an  existing  Statement  or  Branch  or 
Plex  or  Group,  instead  of  "inserting"  a  new  one,  with  this  command.  If  you  choose  TYPEIN 
with  Branch  or  Plex  or  Group,  it  acts  as  Insert  Statement.  After  execution,  you  are  at  the  first 
character  of  the  newly  inserted  STRUCTURE. 

STRUCTURE  =  Statement,  Branch,  Plex,  or  Group:  See  structure. 

TNLS  example: 

BASE  C:  Insert  C:  Statement  (to  follow)  A:  2b3 

L:  d 

T:  I  love  you. 

BASE  C: 

OKINSERT:  See  OKINSERT. 


Insert: 

Status:  Insert  Status  (form  to  follow)  DESTINATION  LEVEL-ADJUST  OK:  The  Sendmail 
subsystem  command  "Insert  Status"  will  insert  a  statement  containing  the  current  status  of 
your  Sendmail  item  at  the  DESTINATION  you  specify.  You  can  modify  this  statement  to 
contain  the  Sendmail  commands  appropriate  for  your  Sendmail  item.  When  this  form  is  edited 
to  your  satisfaction,  use  the  Process  (command  form)  command  in  the  SENDMAIL  subsystem 
to  automatically  execute  every  command  in  the  form.  To  insert  a  complete  empty  command 
form,  use  the  BASE  subsystem’s  Insert  Sendmail  (form)  command. 

Effects:  If  you  Quit  out  of  the  Sendmail  Subsystem  sometime  before  you  go  to  Sendmail 
and  Process  your  status  form,  you  must  re-specify  the  source  of  your  item. 

Sendmail  item:  See  item  (SENDMAIL). 

editing:  See  writing. 

the  form  for  each  command:  See  sendmailforms. 

The  SENDMAIL  Process  (sendmail  form)  command:  See  process  (SENDMAIL). 

The  BASE  Insert  Sendmail  (form)  command:  See  insert  sendmailform. 

Link:  Insert  Link  (to  follow)  DESTINATION  OK:  The  Sendmail  subsystem  command  "Insert 
Link"  causes  the  system  to  create  and  place  a  link  to  the  Sendmail  item  at  the 
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DESTINATION  you  specify  if  you  have  the  right  to  write  on  the  file.  Since  Journal  files 
cannot  be  altered,  this  command  will  not  place  a  link  in  a  Journal  file.  Also,  no  link  will  be 
placed  if  the  Number  command  has  not  been  used  to  assign  a  number. 

Journal  file:  See  journal  file  (SENDMAIL). 

The  Number  command:  See  number  (SENDMAIL). 

Insert  (accum  following)  STRING/STRUCTURE:  The  Calculator  subsystem 
command  "Insert"  inserts  the  value  of  the  accumulator  into  an  NLS  file.  See 
also:  accumulator. 

STRING:  Insert  (accum  following)  STRING  DESTINATION  OK:  Use  this  command  to  insert 
the  value  of  the  accumulator  following  the  type  of  STRING  at  the  DESTINATION  you 
specify.  See  also:  STRING,  DESTINATION,  accumulator. 

STRUCTURE:  Insert  (accum  following)  STRUCTURE  DESTINATION  LEVEL-ADJUST  OK: 
Use  this  command  to  insert  the  value  of  the  accumulator  following  the  type  of  STRUCTURE 
at  the  DESTINATION  you  specify.  See  also:  STRUCTURE,  DESTINATION,  LEVEL-ADJUST, 
accumulator. 

Insert  Format  (at)  DESTINATION  (using  Format  #)  CONTENT:  (Title:) 

CONTENT 

(Author  Ident(s):)  CONTENT 

(Journal  Number:)  CONTENT  (Formatting  File) 

The  Format  user-subsystem  command  "Insert"  adds  directives  and  any  necessary 
special  characters  to  a  file  according  to  a  given  predesigned  format.  You  must 
first  point  to  the  file.  It  then  lists  your  choice  of  formats.  Printed  Samples  of  all 
the  formats  are  available  through  FEEDBACK.  You  type  the  number  of  the 
desired  format. 

Effects:  Unless  the  file  to  be  formatted  is  a  Journal  file,  it  asks  you  to  type  the  title  of  the 
document,  a  list  of  author  idents  (which  may  include  organization  and  group  idents),  and 
finally  the  Journal  number  (in  case  you  have  a  preassigned  number  that  you  wish  put  on  the 
file).  To  skip  any  of  these  fields  in  TNLS  type  CA,  in  DNLS  type  <CTRL-N>.  The 
command  will  insert  the  directives  necessary  to  produce  the  format  you  chose.  It  may  insert 
directives  in  the  origin  statement,  in  every  level  one  statement,  and  in  some  cases  in  the 
statement  back  from  every  level  one  statement.  It  also  creates  a  title  page  as  the  last  level-one 
branch  in  the  file.  The  title,  authors,  and  Journal  number  appear  in  the  title  page  and  in  some 
cases  in  header  or  footer  directives  in  the  origin  statement. 

modifying  the  formatted  file:  The  program  only  inserts  text  in  the  file.  You  may  edit 
any  of  it  as  you  see  fit.  For  example,  if  one  of  the  authors  does  not  have  an  ident,  you 
may  add  his/her  name  to  the  title  page  afterwards.  Or  you  may  edit  the  directives  to 
modify  the  format.  (You  should  feel  fairly  confident  of  your  understandng  of  the  Output 
Processor  before  you  attempt  to  edit  the  more  complex  of  these  formats!)  See  directives. 

Formats  designed  for  COM:  Most  of  the  formats  were  designed  for  Computer  Output  to 
Microfilm  (COM).  The  intent  is  to  make  it  very  easy  for  users  less  experienced  with  the 
Output  Processor  to  take  advantage  of  COM’s  capabilities. 

How  to  have  your  format  and  read  it  too!:  To  be  safe  you  should  use  the  "Format" 
command  on  files  which  previously  have  no  directives  in  them.  Since  directives  can  get  in  the 
way  of  online  reading,  you  may  want  to: 

-Update  File 

-Execute  (command  in)  Format  Insert  Format 

-Output  COM  or  Output  Printer 

-Delete  Modifications 
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This  last  command  undoes  what  the  Insert  Format  command  did.  You  are  then  left  with  a  clean 
file.  You  must  repeat  the  "Insert  Format"  command  to  prepare  it  for  "Output"  a  second 
time.  See  output  printer  file. 

inserting:  See  writing. 

Institute  PROGTYPE  (program)  CONTENT  OK:  The  Programs’  subsystem 
command  "Institute"  activates  a  program  that  has  already  been  loaded  or 
compiled  into  your  buffer.  For  CONTENT,  you  may  use  the  name  of  the 
program  or  its  number  in  your  Buffer.  Specify  the  purpose  of  the  program  for 
PROGTYPE  with  one  of  the  commandwords  listed  below.  Loading  programs 
automatically  institutes  them.  See  also:  instituting,  loading,  compiling,  show 
(PROGRAMS),  commandwords: 

Content  (analyzer):  See  content-analyzer. 

Sequence  (generator):  See  sequence. 

Sort  (key  extractor):  5eesort  (PROGRAMS), 
deinstitute:  See  deinstitute  (PROGRAMS). 

instituting  loaded  programs:  Once  a  program  has  been  loaded  into  the 
programs  buffer,  if  it  is  a  Content  Analyzer  filter,  a  Sort  key  algorithm,  or  a 
Sequence  generator  program,  it  is  instituted  automatically  for  you.  Many 
programs  may  be  loaded  into  the  buffer  at  any  time,  but  only  one  may  be 
instituted  for  each  function.  Controlling  viewspecs  pass  control  to  the  instituted 
program  only.  See  also:  Loading,  Institute. 

interpreter:  CML  interpreter:  a  program  that  interprets  grammars  produced  by 
the  CML  compiler.  However,  it  could  just  as  easily  be  a  machine  whose 
instruction  set  corresponds  to  the  grammars  produced  by  the  CML  compiler. 

Interrogate  OK:  The  Sendmail  subsystem  command  "Interrogate"  asks  you  five 
questions  important  for  sending  a  simple  piece  of  mail. 

(distribute  action  to)  CONTENT:  See  distribute  (SENDMAIL). 

(distribute  information-only  to)  CONTENT:  See  distribute  (SENDMAIL). 

(title)  CONTENT:  See  title  (SENDMAIL). 

(type  of  source)  ITEM:  See  item  (SENDMAIL). 

(show  status)  ANSWER:  See  show  (SENDMAIL). 

(send  the  mail  ?)  ANSWER:  See  send  (SENDMAIL). 

How  to  skip  questions:  To  skip  one  of  the  first  three  questions  and  go  on  to  the  next,  type  an 
OK  (in  DNLS  a  NULL  character  <  CTRL-  N  >  must  precede  the  OK:). 

DNLS:  See  DNLS. 

OK:  See  OK. 

Interrogate:  for  retrieving  Archived  Files, 

use  the  TENEX  interrogate  command.  See  also:  TENEX. 

Invisible:  a  continuous  STRING  of  one  of  the  following  generally  non-printing 
characters.  Pointing  to  any  character  position  within  the  invisible  will  serve  to 
point  to  the  entire  invisible.  See  also:  notation. 
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<ALT>  Altmode  or  Escape  key:  See  alt. 

<CR>:  the  typewriter  key  that  is  used  for  a  carriage  return.  SeeCR. 

<CTRL-*>  control  character  where  *  =  any  character:  represented  as  <CTRL-*>  See 
CTRL-character. 

<EOL>:  end  of  line  SeeEOL. 

<LF>:  linefeed  <CTRL-J>.  SeeLF. 

<NULL>  nothing  <CTRL-N>:  See  NULL. 

<SP>:  space  key  ...  also  represented  as  <  >  SeeSP. 

<TAB>:  See  TAB. 

Item:  one  of  the  following. 

Message:  See  message  (SENDMAIL). 

STRUCTURE:  See  structure. 

Document:  See  Document, 
file:  See  file  (SENDMAIL). 

Offline:  See  offline  (SENDMAIL). 

The  Jump  to  item  command:  See  jump  item. 

iteration:  if  you  don’t  understand  this,  read  it  again. 
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j  ViewspeC:  don’t  filter  statements:  "Ignore  any  content-analyzer."  Viewspec  j 
turns  off  vewspecs  i  and/or  k.  Viewspecs  i,  j,  and  k  are  mutually  exclusive.  You 
can  also  turn  on  viewspec  j  and  turn  off  viewspec  i  or  k  using  the  BASE 
subsystem  command  "Set  Content  (pattern)  Off.  This  is  a  default  viewspec. 

J  Viewspec:  show  statement  numbers,  not  SIDs:  "Use  statement  numbers  for 
statement  identification."  This  viewspec  takes  effect  when  viewspec  m  is  on.  It  is 
also  used  to  change  I  (show  SIDs).  The  viewspecs  G  (right  margin)  and  H  (left 
of  statement)  determine  where  the  statement  numbers  will  appear.  Example:  if 
you  have  SIDs  on  at  the  right  and  want  to  change  to  statement  numbers  at  the 
left,  use  the  string  HJ.  This  is  a  default  viewspec.  See  also:  Statementnumber, 
SID,  m,  Capital-1,  Capital-H,  Capital-G. 

Jnumber:  Seexdoc. 

Journal:  stored  items:  The  database  of  recorded  items  sent  in  the  Sendmail 
subsystem.  This  was  also  a  subcommand  mode  in  old  NLS-7  but  has  been 
replaced  by  the  Sendmail  Subsystem.  See  also:  output  journal,  sendmail, 
distribution,  ITEM,  subcollections,  header. 

catalogs  and  indexes:  See  catalogs. 

SENDMAIL  file:  See  file  (SENDMAIL). 

journal-number:  See  numbering  (SENDMAIL). 

JSYS:  lit.:  "jump  to  system"  The  machine  instruction  used  in  TENEX  to  invoke 
a  monitor  supplied  service;  i.e.  a  jump  to  a  subroutine. 

Jump:  The  command  "Jump" 'moves  you  from  one  file  to  another  or  from  one 
place  in  a  file  to  another.  In  TNLS  you  move  to  a  character  within  a  statement, 
and  in  DNLS,  you  move  to  the  first  character  of  the  statement  you  point  to.  In 
DNLS,  jump  changes  your  view.  For  viewing  in  TNLS,  use  the  Print  command. 

The  ofers  you  a  chance  to  change  of  Jump  commands  is  available  in  all 

subsystems.  See  also:  moving,  jumping,  subsystem,  viewing. 

Address: 

DNLS:  Jump  (to)  Address  (relative  to)  DESTINATION  ADDRESS  VIEWSPECS  OK: 
The  command  "Jump  (to)  Address"  moves  you  to  a  specific  statement.  To  use  a 
address  in  NLS,  the  system  must  know  where  you  start  from.  For  example,  if  you  give 

.n  for  next,  it  must  know  the  statement  where  you  are  (to  go  to  the  next.)  In  this 

command,  you  establish  where  you  are  by  entering  something  at  the  DESTINATION 
step.  Then  you  can  enter  the  address  yoy  want  to  go  to  from  there.  Use  the  Jump  to 


GLOSSARY 


73 


J 


Link  command  to  jump  directly  to  a  statement  not  in  your  window.  See  also: 
ADDRESS,  Jump  Link. 

TNLS:  Jump  (to)  Address  DESTINATION  OK:  The  command  "Jump  (to)  Address" 
moves  you  to  the  location  you  specify.  To  use  a  address  in  NLS,  the  system  must  know 
where  you  start  from.  For  example,  if  you  give  .n  for  next,  it  must  know  the  statement 
where  you  are  (to  go  to  the  next.)  In  this  command,  you  establish  where  you  are  by 
entering  something  at  the  DESTINATION  step.  Then  you  can  enter  the  address  you 
want  to  go  to  from  there.  You  can  move  to  another  file  and/or  move  within  the  file  you 
have  loaded.  If  you  change  files,  the  system  will  print  out  the  new  file’s  name.  You  can 
set  up  viewspecs  for  later  reading,  as  with  the  Print  commands.  See  also:  DESTINATION, 
ADDRESS,  VIEWSPECS,  reading,  moving,  filename. 

TNLS  example: 

BASE  C:  Jump  (to)  C:  Address  A:  onetest,  alice  .e 

BASE  C: 

BUG:  [DNLS  only]  Jump  (to)  BUG  VIEWSPECS  OK:  The  "Jump  (to)  BUG"  command 
moves  you  to  the  first  character  of  the  statement  you  Bug.  You  are  positioned  at  the  statement 
at  the  top  of  the  screen  after  re-creation.  See  also:  jumping,  DNLS,  VIEWSPECS,  re-creating, 
bug. 

Back:  Jump  (to)  Back  DESTINATION  VIEWSPECS  OK:  The  command  "Jump  (to)  Back" 
moves  you  to  the  statement  that  is  back  of  the  one  you  specify  for  DESTINATION.  See  back. 

TNLS  example: 

BASE  C:  Jump  (to)  C:  Back  A:  alice 

V: 

BASE  C: 

Content:  Jump  (to)  Content  First/Next. 

First:  Jump  (to)  Content  First  SEARCH  VIEWSPECS  OK:  SEARCH  =  CONTENT  or 
OKREPEAT 

The  command  "Jump  (to)  Content  First"  will  take  you  to  the  first  time  the  characters 
you  put  in  SEARCH  appear  in  your  file.  You  can  TYPEIN  or  point  to  whatever 
characters  you  want,  or  hit  the  OKREPEAT  character  <  CTRL-B  >  to  search  for 
characters  you  have  already  chosen.  To  repeat  character  search,  use  the  TAB  command, 
<CTRL-I>.  You  cannot  search  for  something  that  is  in  quotes.  See:  TAB,  content. 

TNLS  example: 

BASE  C:  Jump  (to)  C:  Content  C:  First  RPT/T:  T:  soups 

V:  mw 

"soups"=C  ?? 

BASE  C:  Jump  (to)  C:  Content  C:  First  "soups"  RPT/T:  T:  Soups 

V:  mw 

BASE  C: 

Next:  Jump  (to)  Content  Next  SEARCH  VIEWSPECS  OK:  SEARCH  =  CONTENT  or 
OKREPEAT 

The  command  "Jump  (to)  Content  Next"  will  find  the  next  time  the  characters  you  put  in 
for  SEARCH  appear  in  your  file.  You  can  TYPEIN  what  ever  content  you  want,  or  hit 
the  OKREPEAT  character  <  CTRL-B  >  to  search  for  a  CONTENT  you  have  already 
specified.  To  repeat  a  content  search,  use  the  TAB  command.  See:  TAB. 

TNLS  example: 

BASE  C:  Jump  (to)  C:  Content  C:  Next  "Soups"  RPT/T:  T:  Desserts 

V: 

BASE  C: 

Down:  Jump  (to)  Down  DESTINATION  VIEWSPECS  OK:  The  command  "Jump  (to)  Down" 
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moves  you  to  the  statement  that  is  down  from  the  one  you  specify  for  DESTINATION.  See 
down. 

TNLS  example: 

BASE  C:  Jump  (to)  C:  Down  A:  lc 
V: 

BASE  C: 

End:  Jump  (to)  End  (of  branch)  DESTINATION  VIEWSPECS  OK:  The  command  "Jump  (to) 
End  "  moves  you  to  the  end  statement  of  the  branch  that  is  defined  by  what  you  specify  for 
DESTINATION.  See  end. 

TNLS  example: 

BASE  C:  Jump  (to)  C.  End  (of  Branch)  A:  1 
V: 

BASE  C: 

File:  Jump  (to)  File  Named/Retum. 

Named:  Jump  (to)  File  Named  CONTENT  VIEWSPECS  OK:  The  command  "Jump  (to) 

File  Named"  allows  you  to  go  to  the  origin  statement  of  a  file.  Typein  the 

FILEADDRESS  of  the  file  for  CONTENT.  You  need  not  include  the  final  comma.  If 
the  file  is  in  your  connected  directory,  you  may  "point"  to  its  name  instead  of  typing  the 
FILEADDRESS.  The  filename  need  not  be  a  part  of  a  link.  See  also:  FILEADDRESS, 
pointing,  link. 

In  DNLS,  if  the  file  is  in  another  directory,  and  the  filelink  is  in  your  window,  use  the 

Jump  (to)  File  BUG  command  instead.  Note:  Jump  (to)  File  Named  does  not 

follow  the  default  directory  for  links  when  pointing  to  the  FILEADDRESS. 

TNLS  example: 

BASE  C:  Jump  (to)  C:  File  C:  Named  T:  jmb 
V:  eb 

<  BECK,  JMB.NLS;2,  > 

BASE  C: 

Return:  Jump  (to)  File  Return  OK  ("<PAST  FILEADDRESS  > ")  ANSWER:  The 
"Jump  (to)  File  Return"  command  moves  you  to  a  file  where  you  were  before. 
("<PAST  FILEADDRESS  > ")  is  the  name  of  the  file  you  will  go  to  if  you  answer  Yes 
or  hit  CA.  If  you  answer  No,  the  FILEADDRESS  before  that  will  appear.  See  also: 
return. 

TNLS  example: 

BASE  C:  Jump  (to)  C:  File  C:  Return  OK:  "<  BECK,  TALK.NLSjl,  >"Y/N:  OK: 

<  BECK,  TALK.NLS;1,  > 

BASE  C: 

Head:  Jump  (to)  Head  DESTINATION  VIEWSPECS  OK:  The  command  "Jump  (to)  Head" 
moves  you  to  the  statement  that  is  at  the  head  of  the  statement  you  specify  for 
DESTINATION.  See  head. 

TNLS  example: 

BASE  C:  Jump  (to)  C:  Head  A:  lc 
V:  etb 
BASE  C. 

jump  (to)  Return  OK  ("FLASHBACK”)  ANSWER:  The  command  "Jump  (to)  Return"  will 
take  you  back  to  a  previous  statement.  ("FLASHBACK")  represents  the  first  few  characters 
of  the  statement  you  will  go  to  if  you  answer  Yes  or  hit  CA.  If  you  answer  No,  the  beginning 
of  the  previous  position  before  that  will  appear  as  ("FLASHBACK").  See  also:  return. 

TNLS  example: 
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BASE  C:  Jump  (to)  C:  Return  OK:  "  WITH  SOUR  CREAM"  Y/N:  OK: 

BASE  C: 

ANSWER:  See  answer. 

Item:  Jump  (to)  Item  DESTINATION  VIEWSPECS  OK:  The  command  "Jump^  (to)  Item- 
moves  you  to  the  statement  you  specify  for  DESTINATION. 

TNLS  example: 

BASE  C:  Jump  (to)  C:  Item  A:  012 

V:  etb 

BASE  C: 

Link:  Jump  (to)  Link  CONTENT  OK:  The  command  "Jump  (to)  Link"  moves  you  to  the 
ADDRESS  and/or  VIEWSPECS  you  point  to  or  TYPEIN  for  CONTENT. 

TNLS  example: 

BASE  C:  Jump  (to)  C:  Link  T:  talk, 

<  BECK,  TALK.NLS;1,  > 

BASE  C: 

Name:  The  command  "Jump  (to)  Name"  finds  the  statement  labeled  by  a  name  according  to  the 
following  search-types  and  moves  you  to  the  first  character  of  that  statement.  See  also: 
STATEMENTNAME. 

Any:  Jump  (to)  Name  Any  CONTENT  VIEWSPECS  OK:  The  command  "Jump  (to) 
Name  Any"  finds  a  statement  with  the  same  name  as  the  word  (include  dashes  -,  atsigns 
@,  and  apostrophes  ’)  you  specify  for  CONTENT  in  the  fastest  way  possible  regardless  of 
its  position  in  the  file.  You  move  to  the  first  character  of  that  statement.  See  also: 
STATEMENTNAME,  CONTENT,  VIEWSPECS,  BUG. 

TNLS  example: 

BASE  C:  Jump  (to)  C:  Name  C:  Any  T/[A]:  buffalo  V:  w 

BASE  C: 

BUG:  [DNLS  only]  Jump  (to)  Name  BUG  VIEWSPECS  OK:  The  command  "Jump  (to) 
Name  BUG"  finds  a  statement  with  the  same  name  as  the  word  you  bug  (will  include 
any  dashes  atsigns  @,  and  apostrophes  ’)  in  the  fastest  way  possible.  This  is  usually, 
but  not  always  the  first  one  in  the  file.  You  move  to  the  first  character  of  that 
statement.  See  also:  jumping,  DNLS,  VIEWSPECS,  STATEMENTNAME. 

External:  Jump  (to)  Name  External  CONTENT  VIEWSPECS  OK:  The  command  "Jump 
(to)  Name  External"  finds  the  statement  with  the  same  name  as  the  word  (includes 
dashes  -,  atsigns  and  apostrophes  ’)  as  specified  for  CONTENT.  See  also: 
statementname,  CONTENT,  VIEWSPECS,  OK.  See  extemalname. 

First:  Jump  (to)  Name  First  CONTENT  VIEWSPECS  OK:  The  command  "Jump  (to) 
Name  First"  finds  the  first  statement  in  the  current  file  with  the  same  name  as  the  word 
(include  dashes  -,  atsigns  @,  and  apostrophes  ’)  you  specify  for  CONTENT,  and  moves 
you  to  its  first  character.  See  also:  STATEMENTNAME,  CONTENT,  VIEWSPECS. 

TNLS  example: 

BASE  C:  Jump  (to)  C:  Name  C:  First  T:  with 

V: 

BASE  C: 

Next:  Jump  (to)  Name  Next  CONTENT  VIEWSPECS  OK:  The  command  "Jump  (to) 
Name  Next"  finds  the  next  statement  following  your  present  location  that  has  the  same 
name  as  the  word  (include  dashes  -,  atsigns  @,  and  apostrophes  ’)  you  specify  for 
CONTENT.  You  move  to  its  first  character  See  also:  STATEMENTNAME, 
NEXTNAME,  CONTENT,  VIEWSPECS,  next. 
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TNLS  example: 

BASE  C:  Jump  (to)  C:  Name  C:  Next  T:  with 
V: 

BASE  C: 

Next-:  Jump  (to)  Next  DESTINATION  VIEWSPECS  OK:  The  command  "Jump  (to)  Next" 
moves  you  to  the  statement  that  is  next  after  the  one  you  specify  for  DESTINATION.  See 
next. 

Origin:  Jump  (to)  Origin  DESTINATION  VIEWSPECS  OK:  The  command  "Jump  (to)  Origin" 
moves  you  to  the  origin  statement  of  the  file  that  contains  the  statement  you  specified  for 
DESTINATION.  See  origin. 

Predecessor:  Jump  (to)  Predecessor  DESTINATION  VIEWSPECS  OK:  The  command  "Jump 
(to)  Predecessor"  moves  you  to  the  statement  that  is  the  predecessor  of  the  one  you  specified 
for  DESTINATION.  See  predecessor. 

Successor:  Jump  (to)  Successor  DESTINATION  VIEWSPECS  OK:  The  command  "Jump  (to) 
Successor"  moves  you  to  the  statement  that  is  the  successor  of  the  one  you  specified  for 
DESTINATION.  See  successor. 

Tail:  Jump  (to)  Tail  DESTINATION  VIEWSPECS  OK:  The  command  "Jump  (to)  Tail"  moves 
you  to  the  statement  that  is  the  tail  of  the  statement  you  specify  for  DESTINATION.  See  tail. 

Up:  Jump  (to)  Up  DESTINATION  VIEWSPECS  OK:  The  command  "Jump  (to)  Up"  moves 
you  to  the  statement  that  is  up  from  the  one  you  specify  for  DESTINATION,  .  See  up. 

Word: 

First:  Jump  (to)  Word  First  SEARCH  VIEWSPECS  OK:  SEARCH  =  CONTENT  or 
OKREPEAT 

The  command  "Jump  (to)  Word  First"  finds  the  first  occurrence  of  the  word  you  choose 
for  SEARCH.  You  can  TYPEIN  or  point  to  what  ever  CONTENT  you  want,  or  hit  the 
OKREPEAT  character  <CTRL-B>  to  search  for  a  CONTENT  you  have  already 
specified.  To  repeat  a  content  search,  use  the  TAB  command.  See:  TAB,  <CTRL  I>. 

TNLS  example: 

BASE  C:  Jump  (to)  C:  Word  C:  First  RPT/T:  T:  soups 
V:  m 
BASE  C: 

Next:  Jump  (to)  Word  Next  SEARCH  VIEWSPECS  OK:  SEARCH  =  CONTENT  or 
OKREPEAT 

The  command  "Jump  (to)  Word  Next"  will  find  the  next  occurrence  following  your 
present  location  of  the  word  you  specify  for  SEARCH.  You  can  TYPEIN  or  point  to 
whatever  word  you  want,  or  hit  the  OKREPEAT  character  <  CTRL-B  >  to  search  for  a 
word  you  have  already  specified.  To  repeat  a  word  search,  use  the  TAB  command, 
<  CTRL  I  >  .  See:  TAB. 

TNLS  example: 

BASE  C:  Jump  (to)  C:  Word  C:  Next  "SOUPS"  RPT/T: 

V:  m 

BASE  C:  ;  I  used  OKREPEAT  there. 

Jumping  in  DNLS:  The  NLS  feature  you  use  for  moving  to  a  new  place  in  a  file. 
There  is  a  whole  family  of  Jump  commands,  available  in  all  subsystems.  Some 
Jump  commands  take  you  to  a  character  within  a  statement;  some  take  you  to 
files;  and  some  take  you  to  statements  according  to  their  structural  position.  In 
DNLS,  all  of  them  move  you  to  the  first  character  of  the  statement  or  of  the 
origin  statement  of  the  file  addressed.  The  view  you  specify  in  a  Jump  command 
will  appear  in  the  file  display  window  your  cursor  is  in.  When  you  give  the  final 
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OK  for  the  command,  your  screen  will  be  re-created.  See  als< 

structural,  pointing. 

re-creating  the  display:  See  re-creating. 

Jumping  in  TNLS:  See  moving. 


viewing, 
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k  ViewspeC:  show  next  filtered  statement:  "Find  the  next  statement  that  satisfies 
the  content-analyzer,  then  turn  the  content-analyzer  off."  Viewspec  j  causes  all 
statements  to  pass  the  filter,  regardless  of  content.  Viewspec  i  allows  you  to  pass 
all  statements  containing  the  correct  content.  Viewspecs  i,  j,  and  k  are  mutually 
exclusive.  Compare  TAB-command. 

K  Viewspec:  statement  signatures  on:  "Show  statement  signatures  after  each 
statement."  Viewspec  L  suppresses  statement  signatures;  K  switches  them  on. 
Statement  signatures  contain  the  ident  of  the  person  who  last  edited  that 
statement  and  the  date  and  time  of  the  last  edit.  See  also:  IDENT,  Capital-L. 

Keyset:  A  device  with  five  piano-like  keys  for  entering  characters  into  NLS  at  a 
display  console.  Each  key  controls  a  bit  in  5-bit  ASCII  code.  With  your  left 
hand  on  the  keyset  and  your  right  hand  on  the  mouse,  you  can  give  all  input  to 
DNLS  without  ever  moving  your  right  hand  to  the  keyboard,  Moving  both  hands 
to  the  keyboard  is  efficient  for  typing  in  a  long  series  of  text.  Different 
combinations  of  Mouse  buttons  are  used  in  conjunction  with  keyset  combinations 
to  make  this  possible.  The  small  Viewspec/Mouse  and  Keyset  Card  shows  you 
all  the  possible  mouse  and  keyset  combinations.  Ask  your  architect  for  this  Card 
or  address  requests  to  the  IDENT  Feedback.  You  can  also  contact  the 
Augmentation  Research  Center,  SRI,  333  Ravenswood  Avenue,  Menlo  Park, 
Calif,  94025,  (415)326-6200  ext. 3630,  or  in  this  publication  see:  mouse-keyset. 

Mouse-Keyset  combinations:  See  Mouse- Keyset. 

Keywords  CONTENT  OK:  The  Sendmail  subsystem  command  "Keywords" 
allows  you  to  specify  which  words  will  typify  the  nature  of  the  document. 
CONTENT  wants  you  to  indicate  the  keywords.  ARC  does  not  at  present 
produce  keyword  indices  of  journal  items  except  on  request.  However,  words  in 
the  title  are  used  in  the  titleword  index. 

Title  command:  See  title. 

CONTENT:  See  content. 

catalog:  See  catalog. 

subcollection:  See  subcollection. 

Kill  TENEX  (subsystem)  OK:  The  Programs’  subsystem  command  "Kill 
TENEX"  undoes  the  command  "Run  TENEX." 

KW:  Knowledge  Workshop:  SeeAKW. 
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I  ViewspeC:  show  plex  only:  "Show  only  the  plex  of  the  statement  where  you  are 
located."  Only  the  addressed  plex  will  appear.  In  TNLS,  this  affects  the 
operation  of  Output  and  Print  commands.  Viewspec  h  does  NOT  limit  operation 
to  one  plex.  To  show  one  branch  only,  use  g. 

L  Viewspec:  statement  signatures  off:  "Don’t  show  statement  signatures."  L 
switches  off  K  (show  statement  signatures).  This  is  a  default  viewspec.  See  also: 
Statement,  Signatures,  Capital-K. 

L-COlon:  L:  LEVEL-ADJUST  d/u:  See  level -ad just. 

L10:  programming  language:  the  ALGOL-like  procedure-oriented  programming 
language  used  at  SRI-ARC.  Some  of  NLS  is  written  in  L10.  See  programs. 

Binding  Precedence:  Order  of  Operator  Execution  See  Binding. 

L10-HELP:  The  L10  user’s  guide:  See  locator,  userguides,  LI O-guide,  . 

language:  See  command. 

last- name  search:  .lastname,  .last...  If  you  type  in  a  period  and  then  a  last 
name,  the  Sendmail  subsystem  will  find  the  IDENTS  for  all  people  with  that 
last-name.  The  beginning  characters  of  a  last  name  preceded  by  a  period  and 
followed  by  three  periods  will  find  the  IDENTS  for  all  last-names  beginning  with 
those  characters.  If  only  one  IDENT  satisfies  your  request,  you  will  be  shown 
this  IDENT  and  asked  if  it  is  the  correct  one.  Typing  a  CA  will  put  this  IDENT 
into  the  command.  When  an  IDENTLIST  is  called  for,  any  last-name  search 
must  have  a  comma  separating  it  from  the  next  item  in  the  IDENTLIST.  Typing 
a  <  CTRL-O  >  will  stop  an  IDENT  search  at  any  time. 

leaving  NLS  to  TENEX:  To  return  to  the  TENEX  timesharing  system  from  NLS 
use  the  Quit  NLS  command.  After  that,  you  can  type  "con"  followed  by 
carriage  return  at  the  TENEX  herald  to  return  to  NLS.  To  break  contact  with 
TENEX  entirely  use  the  Logout  command  in  TENEX  or  NLS.  To  leave  NLS 
anytime  for  an  excursion  in  TENEX,  use  the  Goto  TENEX  command.  This 
command  issues  to  you  a  second  copy  of  TENEX  called  "inferior  exec".  To 
return  from  this  second  copy  to  NLS,  use  the  TENEX  Quit  command. 

Inferior  Exec:  [TENEX  as  a  subsystem  of  NLS]  See  Inferior. 

The  TENEX  herald  is  the  atsign  (@):  A  herald  is  the  identifying  character(s)  at  the  left 
margin  that  shows  your  current  (sub)system. 

Goto  SUBSYSTEM  command:  See  goto. 

command  to  Quit:  See  quit  NLS. 
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command  to  logout:  See  logout. 

control-c  <CTRL-C>  and  Continue:  5ee<CTRL-C>. 

left  button  down  while  giving  a  keyset  code  =  numbers,  etc.  Holding  down  the  left 
mouse  button  while  giving  a  keyset  code  allows  you  to  input  numerical  and 
nonalphabetic  characters.  See  keyset. 

Left-anglebracket  (<)  command:  Typing  the  left-anglebracket  key  (<)  at  the 
herald  of  a  subsystem  displays  your  subsystem  stack  --  See  stack. 

less-than:  5eelessthan. 

lessthan  symbol:  <  Subsystem  Stack.  See:  stack;  anglebrackets. 

Letter:  The  user-program  "Letter.rel"  asks  questions  and  formats  the  answers  for  a 
business  letter.  It  is  not  a  user-subsystems  and  therefore  does  not  have  the 
prompting,  questionmark,  and  help  features.  You  must  already  have  written  the 
body  of  the  letter.  It  should  be  in  a  file  by  itself  and  you  should  be  in  that  file. 
You  should  also  have  a  pre-assigned  journal  number  and  a  title  ready  to  give  as 
leaving  them  out  causes  the  program  to  do  bad  things.  See  running 
(PROGRAMS). 

level:  In  NLS,  files  are  arranged  in  an  outline  form.  Level  refers  to  how  far  up  or 
down  a  statement  is  in  the  outline.  The  organization  of  all  the  statements 
determines  the  STRUCTURE  of  a  file.  The  level  of  a  statement  is  created  or 
modified  when  you  use  certain  commands  that  prompt  you  with  L:.  Lower  levels 
can  be  hidden  by  level  clipping  viewspecs.  The  normal  indentation  of  different 
statements  in  the  view  of  a  file  shows  their  level  in  the  structure.  If  you  see: 
illustration,  you  will  notice  that  the  statements  at  the  same  indentation  as 
Statement  0  are  first-level  statements  (e.g.  1,  2,  3,  etc.);  statements  indented  3 
spaces  from  first-level  ones  are  second-level  statements  (e.g.  la,  3b,  etc.). 
Third-level  statements  are  called  "down"  from  second-level  ones;  first-level  ones 
are  called  "up"  from  lower  ones.  See:  STRUCTURAL,  clipping. 

If  you  don’t  see  any  level  indentation:  it  doesn’t  necessarily  mean  that  the  statements  aren’t 
arranged  at  different  levels;  the  indentation  itself  could  be  off;  either  your  Useroptions 
Viewspecs  remain  set  to  the  beginner’s  defaults  (See  also:  Viewspecs  (USEROPTIONS)),  or 
you've  put  viewspec  B  on  ( See  also:  B).  Statement  numbers  will  still  show  levels  in  the  file 
structure  when  level-indenting  is  off.  See  also:  statementnumber. 

LEVEL- ADJUST:  See  level -adjust:  . 

level-clipping:  With  reference  to  NLS  Viewspecs,  the  practice  of  controlling  how  deeply  into  the 
outline  structure  of  a  file  you  see  in  any  given  view  one  level.  See  clipping. 

illustration  of  file  structure:  See  illustration. 

See  also:  statement,  statement  numbers,  down,  up. 

LEVEL- ADJUST:  prompted  by  L:  asks  you  to  specify  the  level  you  wish 
STATEMENTS  to  occupy  relative  to  where  you  just  pointed.  If  you  want  to 
change  the  level  type  a  lowercase  d  for  down  or  lowercase  u  for  up.  In  the  Insert 
STRUCTURE  commands,  these  must  be  followed  by  a  space  or  a  CA  before  you 
indicate  the  new  structure.  You  can  type  more  than  one  u  (with  no  spaces  in 
between)  to  go  up  more  than  one  level.  If  you  don’t  want  to  change  levels,  just 
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ignore  the  LEVEL-ADJUST  field  with  a  CA  and  go  on.  See  also:  PROMPTS, 
STRUCTURE,  STATEMENT. 

down:  5eedown. 

tip:  5eeup. 

combinations  of  characters,  u's  and  d’s:  See  combinations. 

level -clipping:  With  reference  to  NLS  Viewspecs,  the  practice  of  controlling  how 
deeply  into  the  outline  structure  of  a  file  you  see  in  any  given  view.  See  clipping. 

<LF>:  linefeed  <CTRL-J>.  The  notation  <  LF  >  represents  the  linefeed  key 
<  CTRL-J  > . 

the  LINEFEED  command:  See  linefeed  (BASE), 
library:  See  userprograms. 

Limit  commandword  feedback  in  TNLS:  When  you  type  one,  two,  or  three 
letters  of  a  command  word  NLS  normally  completes  the  word.  You  may  restrict 
the  number  of  letters  the  system  will  type  back  in  TNLS  with  Useroptions 
Feedback  and  Reset  Feedback  commands  which  specify  Length  (the  default 
Length  is  all  characters  up  to  50). 

Useroptions  feedback  command:  See  feedback  (USEROPTIONS). 

Useroptions  reset  feedback  command:  See  reset  feedback  (USEROPTIONS). 

Limitations  of  the  default  sort:  The  sort  that  NLS  uses  unless  you  specify  a 
different  sort  key  places  certain  special  characters  (CTRL-characters)  first,  then 
all  spaces  and  other  non-letters  or  digits,  then  all  numbers,  then  all  uppercase 
characters,  then  all  lower  case  characters  in  this  order: 

<  TAB  >  <  ESC  >  <SP>  !"#$%&’()*  +  ,  -  ./  0123456789:  ;  <  =  >  ? 
@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]l  _  a 
bcefghijklmnopqrstuvwxyz  J 

line: 

as  a  textual  entity:  NLS  commands  do  not  deal  with  lines  per  se.  The  basic  unit  of  a  file  is  the 
statement,  which  may  be  longer  than  one  line  of  a  standard  typewritten  page.  If  the  statement 
is  longer  than  one  line,  NLS  automatically  breaks  between  words  to  fit  the  statement  to  the 
lines  you  see  on  the  terminal  or  hardcopy.  NLS  manipulates  segments  of  statements;  See  also: 
scrolling,  STRINGS. 

processor  --  line  processor:  See  lineprocessor. 

printer  —  line  printer:  a  piece  of  hardware  that  prints  pages  a  line  at  a  time. 

feed:  linefeed:  See  If. 

<LINEFEED>:  <CTRL-J>:  Typing  the  LINEFEED  key  in  TNLS  will  print  the 
statement  next  to  (below)  the  statement  where  you  are.  See  also:  next. 

TNLS  example: 

BASE  C:  <LF> 

3b  Of  shoes  and  ships  and  ceiling  wax,  of  cabbages 

and  kings. 

BASE  C: 
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Effects:  On  most  terminals,  the  character  for  this  function  is  the  LINEFEED  key  or  <CTRL-J  > . 
No  OK  is  required  in  this  command.  After  execution,  you  are  at  the  first  character  of  the 
statement  printed. 

DNLS:  <  LINEFEED  >:  to  do  the  equivalent  of  the  <  LINEFEED  >  key  in  DNLS,  use  the  Jump 
(to)  Next  command. 

Lineprocessor:  a  device  that  sits  between  certain  alpha-numeric  display  terminals 
and  a  source  of  NLS  computer  service  to  allow  use  of  the  features  of  Display 
NLS. 

Connections:  The  Lineprocessor  must  be  connected  to  a  source  of  computer  service.  It  may  be 
wired  permanently  to  a  computer  or  to  a  TIP  with  access  to  the  ARPANET,  or  it  may  be 
connected  to  a  telephone  through  a  box  called  a  modem  with  or  without  an  acoustic  coupler 
that  cradles  the  receiver. 

Simple  Startup:  See  Simple. 

Link:  a  STRING  of  CHARACTERS  in  a  STATEMENT  that  names  the  address  of 
any  location  in  any  NLS  file  (optionally  with  any  view).  Links  are  surrounded  by 
delimiters  in  the  order  and  format:  <  ADDRESS  :  VIEWSPECS>.  An 
ADDRESS  without  VIEWSPECS  needs  no  colon.  If  you  use  the  VIEWSPEC 
field,  you  must  have  a  colon  preceding  it.  Spaces  are  optional.  You  can  use 
parentheses  "()"  instead  of  angle-brackets  "  <  > ".  Two  dashes  "  also  work  as 

a  left  delimiter.  Pointing  to  any  character  position  ahead  of  or  in  a  link  will  serve 
to  point  to  the  link.  See  also:  pointing. 

ADDRESS:  See  address. 

VIEWSPECS:  See  viewspecs . 

parens  ():  See  parens. 

Warning  with  the  Replace  Link  command:  If  you  attempt  to  replace  a  link  with  something 
that  does  not  fit  legal  link  syntax,  you  will  get  an  error  message,  the  edit  will  not  occur,  and 
thi  text  you  have  typed  to  replace  the  link  will  disappear. 

Linking:  See  connecting. 

literal  escape:  <CTRL-V>:  Typing  the  character  <CTRL-V>  allows  you  to 
insert  a  special  character,  as  part  of  the  text.  Such  special  characters  normally 
make  something  happen  (like  <CTRL-D>).  For  example,  in  TNLS,  you  may 
want  to  insert  a  carriage  return  in  the  text  and  carriage  return,  by  default,  also 
means  command  accept  (CA).  If  you  precede  the  carriage  return  with 

<  CTRL-V  > ,  it  will  not  act  as  CA  for  that  one  time  but  rather  as  a  literal  carriage 
return.  You  can  make  any  additional  key  to  be  your  literal  escape  key  with  the 
Useroptions  Control  command.  See  also:  control,  TYPEIN,  control 

(USEROPTIONS). 

Load  File  CONTENT  OK:  The  command  "Load  File"  will  move  you  to  the  first 
character  of  the  origin  statement  in  the  file  specified  by  the  FILEADDRESS  you 
give  for  CONTENT.  The  file  must  already  exist.  If  the  file  is  located  in  another 
directory,  be  sure  to  specify  it. 

TNLS  example: 

BASE  C:  Load  C:  File  T:  USERGUIDES,  LOCATOR, 

BASE  C. 
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Load  Program  CONTENT  OK:  The  Programs’  subsystem  command  "Load 
Program"  loads  a  pre-compiled  program  into  the  program  buffer  from  the  file 
with  the  FILEADDRESS  you  specify  for  CONTENT. 

TNLS  example: 

PROG  C:  Load  C:  Program  T:  format 
Loading  User  Program 
PROG  C: 

Effects:  See  loading. 

loading  user  program  files:  For  programs  that  have  already  been  compiled  into 
files,  use  the  Load  Program  command  to  get  the  program  into  your  buffer  space 
and  instituted.  First  if  you  do  not  specify  an  EXTENSION,  it  will  look  in  your 
connected  directory  for  a  file  with  an  EXTENSION  in  the  order  listed  below.  If 
it  does  not  find  the  file,  it  will  look  in  the  directory  PROGRAMS.  The  Load 
Program  command  will  do  different  things  depending  on  the  EXTENSION  field 
of  the  program's  FILENAME.  You  may  use  <ALT>  for  filename  recognition. 
See  also:  Load  (PROGRAMS),  FILENAME,  EXTENSION. 

.REL;  RELocatable  L10  program  (file):  SeeREL. 

,CA;  content-analyzer  Program:  See  CA. 

.SK;  Sort  Key  program:  5eeSK. 

.SG;  Sequence  Generator  program:  5eeSG. 

.SUBSYS;  An  L10  program  written  to  support  a  CML  program:  SeeSUBSYS. 

.CML;  Command  Meta  Langauge:  See  CML. 

.PROC-REP;  An  L10  Procedure  Replacement  program:  SeePROC-REP. 
instituting  loaded  programs:  See  instituting, 
buffers:  See  buffers. 

Stacks:  See  stacks, 
library:  See  userprograms. 

locating  your  position  in  a  file:  There  are  several  ways  you  can  show  your 
location  without  changing  it.  Typing  a  Period  (.)  at  a  herald  in  TNLS  will  print 
your  location  as  a  character  position  and  a  statement,  both  indicated  by  numbers. 
Typing  a  Slash  (/)  at  a  herald  in  TNLS  will  print  the  location  in  the  context  of  a 
few  of  the  characters  on  either  side  of  it.  There  are  two  ways  (which  you  can  use 
in  DNLS  too)  which  show  your  location  within  an  ADDRESS:  backslash  (\), 
which  prints  statement,  and  slash  (/),  which  prints  context. 

period  [  .  ]  command:  See  period  (BASE). 

backslash  [\]:  See  backslash. 

slash  [/]:  See  slash. 

locator  file:  The  file  named  <  userguides,  locator,  >  is  an  outline  of  documents.  In 
Locator,  links  are  arranged  to  lead  you  easily  to  useful  views  of  actual  documents. 
Branch  1  of  locator  instructs  you  how  to  use  locator.  Further  guidance  appears 
as  needed  in  the  subject  files.  You  cannot  currently  access  the  locator  file  with 
the  Help  command.  In  TNLS,  say  "Print  Branch  userguides,  locator,  1  .1" 
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followed  by  a  carriage  return.  In  DNLS  say  "Jump  (to)  Link  userguides, 
locator,"  followed  by  CA. 

Locked  file:  See  modification. 

login  (to  TENEX):  When  your  terminal  is  connected,  type  <CTRL-C>  to  get  the 
attention  of  TENEX.  You  will  see  a  login  message  and  then  the  TENEX  herald, 
@,  at  the  margin.  (If  you  enter  through  the  Network,  it  hits  the  first  <CTRL-C> 
for  you.)  Then  type  your  username  followed  by  the  carriage  return  key.  Then 
you  will  see  typed  "(password)",  and  you  should  type  your  password  and  a 
carriage  return.  Then  you  will  see  typed  "(account)",  and  you  should  type  a 
carriage  return.  When  the  herald  appears  again,  you  have  logged  into  TENEX. 

TENEX:  See  TENEX. 

TENEX-herald:  5b? TENEX-herald. 

password:  See  password . 

account:  See  account. 

NLS  (How  to  get  NLS):  5t**NLS. 

If  you’re  not  on  a  Tl  (upper/lower  case)  or  TTY-35:  See  terminal -type. 

Logout  OK:  The  NLS  command  "Logout"  causes  you  to  leave  both  the  NLS 
system  and  the  TENEX  Executive  level  at  once.  It  is  equivalent  to  using  the  Quit 
NLS  command  and  then  TENEX’s  Logout  command. 

TNLS  example: 

BASE  C:  Logout 

TERMINATED  JOB  #.  USER... 

Ip:  See  lineprocessor. 

LSEL:  Literal  SELection:  a  synonym  for  content:  See  content. 
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m  ViewspeC:  statement  numbers/SIDs  on:  "Show  statement  identification." 
Using  m  with  J  turns  on  statement  numbers.  Using  m  with  I  turns  on  SIDs. 
Viewspec  n  turns  off  all  identification.  G  will  put  the  statement  identification  at 
the  right  margin;  H  will  place  it  at  the  left.  Example:  string  mIG  will  make  the 
SID  for  each  statement  appear  after  it  at  the  right  margin.  See  also: 
statementnumber,  G  viewspec,  H  viewspec,  I  viewspecc,  J  viewspec. 

mail:  See  sendmail  and  sndmsg. 

Mark  Character  (at)  DESTINATION  (with  marker  named)  CONTENT 
OK:  The  command  "Mark  Character"  assigns  a  marker  at  the  DESTINATION 
you  specify  in  the  file,  with  the  name  you  specify  as  CONTENT.  See:  bugmark, 
cursor. 

TNLS  example: 

BASE  C:  Mark  C:  Character  (at)  A:  la(with  marker  named)  T/[A]:  tiger 

BASE  C: 

See  also:  Show  Marker,  Delete  Marker,  Delete  All. 

MARKER:  #MARKER  (preceded  by  poundsign):  1-5  alphanumeric  characters 
(inch  hyphen  and  quote),  that  are  assigned  to  a  particular  character  position  in  a 
file.  You  can  point  to  a  marked  character  by  using  the  marker  name  preceeded 
by  #  in  an  ADDRESS  expression.  You  can  also  point  there  in  DNLS  by  holding 
down  the  right-most  button  on  the  mouse  and  typing  in  the  marker  name.  Assign 
markers  with  the  Mark  command.  They  are  normally  invisible  when  viewing 
your  file,  but  you  can  see  a  list  of  all  your  file’s  markers  with  the  Show  Marker 
list  command. 

examples  of  pointing  with  markers:  If  a  marker’s  name  is  "signal",  typing  #signal  for  an 
address  or  holding  down  the  right-most  button  on  the  mouse  and  typing  signal  will  take  you  to 
that  marker  when  prompted  for  a  bug  or  address. 

Mark  command:  5eemark. 

Show  Marker  (list)  command:  5eeshow  marker  (BASE). 

Delete  Marker  command:  See  delete  marker. 

Delete  All  Markers  command:  See  delete  all. 

menu:  A  numbered  list  of  related  subjects  that  may  follow  an  explanation  in  the 
Help  command.  This  list  is  called  a  menu.  Typing  a  number  followed  by  OK 
will  show  the  explanation  named. 

Merge:  Merge  STRUCTURE  (at)  DESTINATION  (into)  DESTINATION  OK: 
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This  command  moves  and  combines  a  plex,  a  group,  or  the  substructure  of  a 
branch  into  another  of  the  same  kind. 

TNLS  example: 

BASE  C:  Merge  C:  Plex  (at)  A:  2a  1 

(into)  A:  5bl 

BASE  C: 

Effects:  "Merge  Statement"  has  no  meaning.  If  both  STRUCTURES  have  been  previously 
sorted  with  the  Sort  command,  the  merged  STRUCTURE  will  be  properly  sorted.  After 
execution,  you  are  at  the  first  character  of  the  first  statement  of  the  new  group  or  plex. 

Message  -  one  of  the  following: 

message  in  the  NLS  Sendmail  subsystem:  Message  CONTENT  OK:  The  Sendmail 
subsystem  command  "Message"  allows  you  to  type  one  statement  (up  to  2000  characters). 
You  may  use  backspace  character  (BC)  and  backspace  word  (BW)  to  edit  the  message  and 
<CTRL-R  >  to  see  what  you’ve  written. 

BW:  See  backspace. 

BC:  5eebc. 

<CTRL-R>:  See  CTRL-r. 

The  sendmail  subsystem:  See  sendmail. 

more  about  messages:  A  Journal  or  Sendmail  message  is  any  Item  that  consists  of  less 
than  2000  characters.  When  received,  the  entire  message  appears  in  the  initial  file  of  the 
receiving  individuals.  Messages  are  stored  with  other  messages  in  large  files  in  the 
Journal  directory.  Items  over  2000  characters  are  called  "documents". 

Item:  See  item  (SENDMAIL). 

Initial  file:  See  initial. 

The  Send  command:  See  send. 

message  in  the  TENEX  system:  (MESSAGE.TXT  TENEX)  file:  When  someone  sends  you  a 
message  via  the  TENEX  SNDMSG  system,  a  file  called  MESSAGE.TXT;  is  created  to  contain 
it.  To  read  your  unread  messages  in  TENEX,  type  MESSAGE  <  CR  >  or  type  REA  <  ESC  > 

<  CR  >  <  CR  >  .  To  read  your  TENEX  messages  in  NLS,  use  the  Message  user-subsystem.  Use 
the  SENDMAIL  subsystem  to  send  messages  in  NLS.  Occasionally  delete  your  MESSAGE. 
TXT  file  so  it  doesn’t  get  too  big.  When  you  delete  and  expunge  the  MESSAGE.  TXT  file, 
all  of  your  messages  go  away,  but  the  filename  remains  as  a  deleted  file  until  you  get  a  new 
message. 

the  message  user-subsystem:  Message:  The  user-subsystem  "Message"  contains  the 

following  commands  for  using  NLS  to  handle  SNDMSGs. 

Copy  Message  (File)  OK  (to  follow)  DESTINATION  LEVEL-ADJUST  OK:  The 

Message  user-subsystem  command  "Copy"  will  copy  your  MESSAGE.TXT  file  to  the 
DESTINATION  you  point  to.  It  changes  the  format  to  make  the  messages  easy  to 
handle  in  NLS. 

Move  Message  (File)  OK  (to  follow)  DESTINATION  LEVEL-ADJUST  OK:  The 
Message  user-subsystem  command  "Move"  will  copy  your  MESSAGE.TXT  file  at  the 
DESTINATION  you  point  to  and  then  delete  the  MESSAGE.TXT  file.  It  changes  the 
format  to  make  the  messages  easy  to  handle  in  NLS.  A  TENEX  work  file  should 
contain  your  messages  in  case  something  goes  wrong. 

Send  Message  (structure:)  OK.  (To  (and  cc):)  CONTENT 

(Subject:)  CONTENT 

(Message/STRUCTURE:)  MSGITEM 

(Status  of  the  distribution  is  diplayed  here) 

(Send  the  message?  (Type  n  to  add  to  list))  ANSWER  OK 


GLOSSARY 


87 


MSGITEM  =  Message  CONTENT  or  Statement/Branch/Group/Plex 
DESTINATION:  The  Message  user-subsystem  command  "Send"  asks  the 

preceding  questions  and  then  sends  a  TENEX  SNDMSG  to  the  MESSAGE.TXT 
file  of  the  people  whose  usernames  or  IDENTs  you  specify.  You  can  say 
"Message"  for  MSGITEM  and  TYPEIN  or  point  to  the  "text"  you  wish  to  send; 
OR  you  can  specify  a  STRUCTURE  command-word  and  point  to  a  STRUCTURE 
you  have  already  created. 

Sort  Message  (Plex  at)  DESTINATION  OK:  The  Message  user-subsystem  command 
"Sort"  orders  your  messages  by  date  most  recent  first. 

Reformat  (citations  in)  STRUCTURE  (at)  DESTINATION  OK:  The  Message 
user-subsystem  command  Reformat"  will  reformat  your  sendmail  citations  to 
correspond  with  the  way  the  Message  user-subsystem  command  "Copy"  and  "Move" 
reformats  sndmsgs  including  date  of  receipt  and  the  distribution  list  if  possible. 

middle  mouse  button:  See  Mouse. 

Minus:  See  also:  minus  (CALCULATOR) .  See  stringposition  or  subtract. 

modification  (file):  a  file  containing  the  changes  you  have  made  on  an  NLS  file. 
You  can  edit  files  temporarily  or  permanently  with  the  NLS  BASE  subsystem. 
Temporary  modifications  reside  in  a  holding  file.  The  name  you  were  logged  in 
under  when  you  made  the  modifications  precedes  the  filename  in  parentheses.  Its 
version  number  is  the  same  as  the  NLS  file,  but  its  extension  is  .PC;  (for  Partial 
Copy)  instead  of  .NLS;.  This  file  disappears  after  the  Update,  or  Delete 
Modification  command.  The  Update  command  incorporates  the  changes 
permanently  into  the  NLS  file.  To  delete  the  modifications  you  have  made  since 
the  last  update,  use  the  Delete  Modification  command.  See  also: 
modifying-commands. 

Logging  Out  before  updating:  If  you  logout  without  updating  and  thus  leave  a  modification 
file  hanging,  it  will  be  there  the  next  time  you  login. 

Restrictions:  The  system  prevents  you  from  changing  or  establishing  modification  files  for  certain 
NLS  files  such  as  a  file  where  someone  else  has  created  a  modification  file,  or  a  file  that  you 
are  not  allowed  to  write  on. 

You  may  load  a  file,  and  then  someone  else  may  load  the  same  file  and  begin  to  make 
modifications  on  that  file.  If  you  also  start  to  make  modifications,  the  first  OK  that  you  hit 
will  give  you  the  message  that  the  file  is  already  being  modified.  The  command  you  were 
inputting  will  be  completely  erased. 

There  is  no  way  to  view  the  contents  of  someone  else’s  modification  file:  Modification  files  work 
like  transparent  overlays  on  illustrations.  If  some  other  user  loads  the  file  you  are  making 
changes  on,  he  will  not  see  the  changes.  The  file  will  look  like  it  did  after  the  last  update.  The 
system  tells  you  that  the  file  is  being  modified  by  another.  The  modifications  file  itself  is 
meaningless  without  the  corresponding  NLS  file  and  there  is  no  point  in  trying  to  load  it 
separately. 

Delete  Modifications  command:  See  delete  modifications. 

editing  commands:  See  commands  (BASE). 

temporary  modification.-  See  temporary. 

Update  File  command:  See  update. 

modified  file:  See  modification. 

Modify:  The  user-subsystem  "Modify"  contains  three  commands  which  are 

extensions  of  the  BASE  subsystem's  editing  commands.  See  also:  writing. 
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Append  Group/PLex  (at)  DESTINATION  (join  with)  CONTENT  OK:  The  Modify 
user-subsystem  command  "Append"  will  append  all  of  the  statements  in  the  Group  or  Plex 
you  specify  to  one  another  successively.  If  any  of  these  statements  has  sub-statements,  the 

sub-statements  will  be  placed  together  in  order  under  the  new  single  statement.  When  the 

accumulated  statements  reach  the  maximum  size  (2000  characters).  NLS  starts  a  new 
statement.  See :  Append  (BASE). 

Delete  Column  /  Leading  /  Names  ... 

Column:  Delete  Column  (of  width  beginning  at)  DESTINATION  (through) 

DESTINATION  OK:  The  Modify  user-subsystem  command  "Delete  Column"  will 
delete  the  text  between  the  points  in  the  line  you  point  to.  It  will  do  this  in  all 

statements  in  the  plex  with  the  same  level  as  the  level  of  the  statement  you  point  to. 

Visible:  Delete  Visible  (beginning  in  column  of  width)  DESTINATION  (through) 
DESTINATION  OK:  The  Modify  user-subsystem  command  "Delete  Visible"  will 
delete  the  text  between  the  points  in  the  line  you  point  to  only  if  the  first  character 
of  the  column  starts  with  a  visible.  It  will  do  this  in  all  statements  in  the  plex  with 
the  same  level  as  the  level  of  the  statement  you  point  to. 

Leading:  Delete  Leading  (spaces  in)  STRUCTURE  (at)  DESTINATION  OK  /  [FILTER 
OK]:  The  Modify  user-subsystem  command  "Delete  Leading"  will  delete  spaces  that 
begin  statements.  See  also:  FILTER. 

Names:  Delete  Names  (in)  STRUCTURE  (at)  DESTINATION  OK  /  [FILTER  OK] 
The  Modify  user-subsystem  command  "Delete  Names"  will  delete  the  names  that  begin 
statements.  See  statement- names.  See  also:  FILTER. 

Force  (sentence  case  in)  STRUCTURE  (at)  DESTINATION  OK:  The  Modify 
user-subsystem  command  "Force"  will  change  statements  that  are  all  upper  case  to  lowercase 
leaving  upper  case  characters  at  the  beginning  of  the  statement  and  following  spaces  after  a 
period,  questionmark,  or  exclamation  point. 

Insert  Front/Back  (of)  STRUCTURE  (at)  DESTINATION  (the  text)  CONTENT  OK: 
The  Modify  user-subsystem  command  "Insert"  augments  the  NLS  BASE 
subsystem  insert  command. 

Front:  Insert  Front/Back  (of)  STRUCTURE  (at)  DESTINATION  (the  text)  CONTENT 
OK:  The  Modify  user-subsystem  command  "Insert"  adds  the  characters  you  specify  for 
CONTENT  to  the  beginning  or  end  of  every  statement  in  the  STRUCTURE  at  the 
DESTINATION  you  specify. 

Filter  option:  Before  specifying  the  STRUCTURE  to  be  modified,  you  may  type 
<CTRL-U>  to  have  the  insertion  operate  through  the  FILTER  viewspecs  you 
specify. 

Insert  Front/Back  (of)  [Filtered:  VIEWSPECS]  STRUCTURE  (at) 

DESTINATION  (the  text)  CONTENT  OK: 

STRUCTURE:  Statement,  Branch,  Group,  or  Plex:  See  structure. 

Address:  Insert  Address  (for  ident(s))  CONTENT  (to  follow  statement  at) 

DESTINATION  LEVEL-ADJUST  OK  The  Modify  subsystem  command  "Insert 
Address"  inserts  the  U  S.  Postal  Address  after  the  DESTINATION  you  point  to  for 
any  list  of  IDENTs  you  specify. 

IDENT:  5eeident. 

modifying-commands:  Replace,  Copy,  Transpose,  etc.  See  also:  file-handling. 
Append  Statement  (at)  SOURCE  (to)  DESTINATION  CONTENT  OK:  See  Append. 

Break  Statement  (at)  DESTINATION  LEVEL- ADJUST  OK:  See  Break. 
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Copy:  See  Copy. 

Delete:  See  Delete. 

Edit:  Edit  Statement  (at)  DESTINATION  EDITSTRING  OK:  5eeEdit. 

Force  (Case):  See  Force. 

Insert:  See  insert. 

Merge:  Merge  STRUCTURE  (at)  DESTINATION  (into)  DESTINATION  OK:  See  Merge. 

Move:  5eeMove. 

OKINSERT:  See  OKINSERT. 

Replace:  See  Replace. 

Reset  Case  Mode:  See  reset  case. 

Sort  STRUCTURE  (at)  DESTINATION  OK:  See  Sort. 

Substitute  STRING  (in)  [(Filtered:  )  FILTER]  ...  See  Substitute. 

Transpose:  See  Transpose. 

Update  File:  See  Update. 

Delete  Modifications:  See  delete  modifications. 

Undelete  Modifications:  See  undelete  modifications. 

modifying:  See  writing. 

Monitor:  A  program  which  remains  in  memory  at  all  times  and  controls  the 
coming  and  going  of  data  and  other  programs  in  the  machine. 

Mouse:  A  handsized  device  normally  operated  by  the  user's  right  hand  when  using 
NLS  from  a  display  console.  The  mouse  rolls  freely  on  any  flat  surface,  causing  a 
cursor  (or  mark)  on  the  display  screen  to  move  correspondingly.  Although  you 
need  only  use  the  first  four  below,  almost  every  combination  of  buttons  on  the 
mouse  means  something.  See  also:  DNLS,  mouse -keyset,  bug. 

right  button  alone  =  BUG  /  CA:  the  Command  Accept  key.  The  right  button  on  the  mouse 
works  just  as  the  CA  key  on  the  keyboard. 

left  button  alone  =  BC:  the  Backspace  Character  key.  The  left  button  on  the  mouse  works 
just  as  the  BACKSPACE  key  on  the  keyboard. 

center  button  alone  =  CD:  the  Command  Delete  key.  The  center  button  on  the  mouse  works 
just  as  the  CD  key  on  the  keyboard. 

left&center  buttons  down  while  typing  a  letter  =  VIEWSPEC:  Typing  a  letter  while 
holding  the  left&center  buttons  down  on  the  mouse  specifies  a  lower-case  viewspec.  For  a 
capital-letter  viewspec,  hold  all  three  buttons  down  while  typing  the  letter.  You  can  specify 
viewspecs  anytime;  NLS  doesn't  have  to  be  ready  for  a  new  command.  Your  viewspecs  will 
change  immediately,  though  the  screen  won’t  show  the  change  until  you  input  an  f  viewspec. 

right&center  buttons  alone  =  OKREPEAT:  Holding  down  the  right  and  center  buttons  on 
the  mouse  as  the  final  confirmation  of  a  command  gives  you  the  OKREPEAT  function. 

left&center  buttons  alone  =  BW:  the  Backspace  Word  key.  The  left  and  center  button  on 
the  mouse  pressed  at  the  same  time  and  then  released  works  just  as  the  BACK  SPACE  WORD 
key  on  the  keyboard.  See  BW. 

right&left  (outside)  buttons  alone  =  ALT  MODE  or  ESCAPE:  Holding  down  the  right 
and  left  outside  buttons  on  the  mouse  works  as  ALT  MODE  or  ESCAPE.  It  works  just  as  the 
ALT  MODE  or  ESC  key  on  the  keyboard.  It  may  echo  as  <ESC>. 
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all- buttons  alone  does  nothing.  This  can  be  very  useful:  If  you  have  pushed  a  mouse 
button  down  by  mistake,  push  down  the  other  two,  then  let  all  three  up. 

center  button  down  while  typing  a  letter  =  Capital  letters:  Holding  down  the  center 
mouse  button  while  typing  a  letter  causes  the  letter  to  be  taken  as  a  capital  letter. 

left  button  down  while  giving  a  keyset  code  =  numbers,  etc.  Holding  down  the  left  mouse 
button  while  giving  a  keyset  code  allows  you  to  input  numerical  and  nonalphabetic  characters. 

right  and  center  buttons  down,  typing  a  character  =  CTRL-CHARACTER:  Holding 
down  the  right  and  center  mouse  buttons  allows  you  to  specify  a  CTRL-character.  It  works 
just  as  if  you  held  down  the  CTRL  key  while  typing  the  character.  This  feature  will  eventually 
be  eliminated. 

right  button  down  while  typing  characters  =  Marker  Search  (on  keyset  or  keyboard): 
Holding  down  the  right-most  mouse  button  while  typing  or  using  the  keyset  inputs  the  name  of 
a  marker.  You  must  finish  giving  the  marker  before  you  let  up  the  mouse  button.  The  marker 
with  that  name  can  be  used  to  indicate  a  DESTINATION  in  a  command. 

all-buttons  down  while  typing  a  letter  =  CAPITAL  VIEWSPEC  (on  keyset  or 
keyboard):  Holding  down  all  the  mouse  buttons  while  typing  a  letter  specifies  a  Capital-letter 
viewspec;  e.g,  if  you  type  the  keyset  code  for  "k"  while  holding  down  all  three  mouse  buttons, 
viewspec  K  will  immediately  be  taken.  You  can  specify  viewspecs  anytime;  NLS  doesn’t  have 
to  be  ready  for  a  new  command.  Your  viewspecs  will  change  immediately,  though  the  screen 
won’t  show  the  change  until  you  input  an  f  viewspec  (while  holding  the  two  left  buttons  down). 
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Move: 

The  command 

"Move” 

transfers  one  of  the  following  SOURCES  you 

specify  to  the  DESTINATION  you  specify.  It  combines  the  Insert,  Copy,  and 
Delete  commands.  Move  does  not  pay  attention  to  the  viewspecs  you  have  on 
(i.e.,  it  works  throughout  the  STRUCTURE  you  point  to  whether  all  of  it’s 
visible  to  you  or  not),  unless  you  specify  VIEWSPECS  in  the  FILTER  option, 
which  pays  attention  to  level,  content  analyzer,  names,  and  sequence  generator 
viewspecs.  You  cannot  limit  the  effects  to  certain  lines  (like  first  lines  only)  with 
a  filter. 


STRING:  Move  STRING  (from)  SOURCE  (to  follow)  DESTINATION  OK:  This  group  of 
"Move"  commands  moves  a  STRING  to  another  location. 
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STRING:  Move  STRING  (from)  SOURCE  (to  follow)  DESTINATION  OK:  This  group  of 
"Move"  commands  moves  a  STRING  to  another  location. 

TNLS  example: 

BASE  C:  Move  C:  Character  (from)  A:  3d  "use." 

(to  follow)  A:  "end  of  sentence" 

BASE  C: 

Effects:  SOURCE  includes  the  choice  of  TYPEIN,  that  is,  you  can  "insert"  a  new 

STRING,  instead  of  "moving"  one,  into  the  new  location  with  this  command.  After 
execution,  you  are  at  the  last  character  of  the  STRING  in  its  new  place. 

STRING:  Character,  Text,  Word,  Visible,  Invisible,  Number,  or  Link  See  String. 

STRUCTURE:  Move  STRUCTURE  (from)  SOURCE  (to  follow)  DESTINATION  [(Filtered:) 
FILTER]  LEVEL-ADJUST  OK 

This  group  of  "Move”  commands  moves  a  STRUCTURE  to  another  location. 

TNLS  example: 

BASE  C:  Move  C:  Group  (from)  A:  3dl 
through  A:  3d5 
(to  follow)  A:  2a 
L:  d 

BASE  C: 

Effects:  SOURCE  includes  the  choice  of  TYPEIN,  i.e.,  you  can  "insert"  a  new  statement, 
instead  of  "moving"  one,  into  the  new  location  with  this  command.  After  execution, 
you  are  at  the  first  character  of  the  STRUCTURE  in  its  new  place. 

FILTER  option:  enter  VIEWSPECS:  With  this  option  in  force  only  statements  move  tha/t 

"pass"  certain  viewspecs  you  can  specify  as  a  string  of  character  codes.  Type  the 

OPTION  character  first  and  then  enter  any  combination  of  the  following  Viewspecs:  for 
level-a,  b,  c,  d,  e,  w,  x;  for  content  analyzer-i,  j,  k;  for  sequence  generator-O,  P.  If  the 
filtering  leaves  statements  somewhere  without  a  source,  substatements  will  move  up  in 
level.  After  using  this  option,  you  will  be  able  to  specify  a  LEVEL-ADJUST.  See  also: 
viewspecs,  source,  substatement,  level,  LEVEL- ADJUST. 

STRUCTURE:  Statement,  Branch,  Plex,  or  Group:  See  structure. 

Edge:  [DNLS  only]:  Move  Edge  (from)  BUG  (to)  BUG  OK:  The  command  "Move  Edge" 

moves  from  one  place  on  the  screen  to  another  the  edges  of  windows  that  have  been  created 

with  the  Insert  Edge  command.  Use  the  Delete  Edge  command  to  get  rid  of  a  window. 

File:  Move  File  (from  old  filename)  CONTENT  (to  new  filename)  CONTENT  OK:  The 

command  "Move  File"  transfers  a  file  from  one  directory  to  another.  It  is  the  equivalent  of 
the  TENEX  Rename  file  command.  The  name  of  the  file  will  change  to  the  name  you  give.  If 
you  don’t  specify  a  version  number,  the  file  will  be  numbered  one  number  higher  than  the 
highest  version  of  the  file  with  the  same  name  (version  1  if  it’s  a  new  name).  The  old  name 
will  appear  in  the  origin  statement  until  you  Update  the  file. 

TNLS  example: 

BASE  C:  Move  C:  File  (from)  old  filename  F:  latra 
(to  new  filename)  T:  trala 
BASE  C: 

moving  around  in  files  and  printing  on  your  terminal  in  TNLS:  The 
family  of  Jump  and  Print  commands  are  used  to  view  information  in  TNLS. 
Jump  to  Address  is  the  basic  TNLS  pointing  command.  Other  Jump  commands 
point  to  a  character  within  a  statement;  some  point  to  files;  and  some  point  to 
statements  by  their  structural  position.  See  also:  pointing,  file,  structural. 
Jump,  and  printing. 
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Multiline  Controller:  a  specially  designed  multiplexor-like  device  which  supports 
the  access  of  up  to  64  terminals  of  varying  type  into  a  TIP. 

Multiply  CONTENT  OK:  The  Calculator  subsystem  command  "Multiply" 

multiplies  the  value  of  the  accumulator  by  the  number(s)  you  specify  for 
CONTENT.  See  also:  operators,  accumulator,  CONTENT,  OK. 
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n  ViewSpeC:  statement  numbers/SIDs  off:  "Don’t  show  any  statement 

identification."  This  viewspec  turns  off  viewspec  m  (show  statement 

identification).  This  is  a  default  viewspec.  5ee  also:  statementnumber, 
Capital-G,  Capital-H,  Capital  —  I,  Capital  — J - 

name: 

marker  name:  See  marker, 
statement  name:  See  statementname. 
filename:  See  fileaddress. 
username  (directory  name):  See  username, 
site  name:  See  site. 

NAME:  the  field  in  a  FITENAME  portion  of  a  FILEADDRESS  that  can  contain 
up  to  39  letters,  numbers,  dashes,  and  a  few  other  special  characters.  It  may  be 
preceded  by  a  directory  name  and  it  may  be  followed  by  an  extension  field.  You 
can  make  the  system  type  most  of  it  by  using  <ALT>,  <CTRL-F>,  and  stars. 
See  also:  FILENAME,  recognition,  directory,  extension. 

Name  (delimiters  defaults):  (left  delimiter)  CONTENT  (right)  CONTENT 
OK: 

This  useroptions  command  sets  the  statement  name  delimiters  to  the  characters 
you  specify  for  CONTENT.  These  will  be  in  effect  whenever  you  create  a  file  or 
use  the  Reset  Name  delimiters  command.  Only  one  character  is  allowed  for  the 
left  delimiter  and  one  for  the  right.  If  you  do  not  use  this  command  your 
statementname  delimiters  will  be  NULL  NULL.  See  also:  statementname, 
name-delimiters,  show  name  (USEROPTIONS),  reset  name  (USEROPTIONS), 
set  name  (BASE),  reset  name  (BASE),  show  name  (BASE). 

name  — delimiters:  the  characters  which  enclose,  and  thus  define  for  system 
recognition,  statement  names.  The  default  name  delimiters  are  NULL  NULL. 
This  means  the  first  word  of  every  statement  that  begins  with  a  letter,  or  atsign  is 
named  and  the  name  is  the  first  word  of  the  statement.  With  this  default,  you 
can  unname  any  statement  by  adding  a  space  (or  other  character)  to  the  beginning 
of  the  statement.  A  new  statement  you  TYPEIN  will  have  the  same  delimiters  as 
its  source.  A  delimiter  may  be  any  letter  OTHER  than  those  reserved  for 
statementnames.  Invisible  characters  after  the  name  before  the  right  delimiter  will 
be  ignored.  You  can  change  your  name  delimiters  with  one  of  the  following 
commands.  See  also:  STRUCTURE,  source,  INVISIBLE,  STATEMENTNAME. 
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Set  Name  (delimiters)  command:  5eeset  name. 

Reset  Name  (delimiters)  command:  See  reset  name. 

Show  Name  (delimiters)  command:  See  show  (BASE). 

USEROPTIONS  Name  (delimiter  defaults)  command:  See  name  (USEROPTIONS). 

NDDT:  See  NLS-DDT. 

net:  See  network. 

Network:  An  interconnected  community  of  computers  such  as  the  ARPANET 
operating  with  a  plan  for  the  systematic  handling  and  relay  of  computer  traffic. 
See  ARPANET. 

NEWFILELINK:  the  part  of  a  command  that  accepts  the  name  of  a  new  file  in  the 
form  of  a  FILEADDRESS.  See  fileaddress. 

next:  the  statement  immediately  following  your  current  statement  regardless  of  its 
level  in  the  outline.  If  you  turn  to  "illustration"  (in  Section  I),  lb3  is  next  to  lb2; 
statement  2  is  next  to  lb3.  Back  is  the  opposite  of  next.  The  LINEFEED 
command  in  TNLS  prints  the  "next"  statement.  See  illustration. 

NEXTNAME:  *statementname  (preceded  by  a  star):  an  address  element  that 
moves  you  to  the  first  character  of  the  next  statement  with  that  name  in  the  NLS 
outline  structure.  To  search  for  the  first  name,  use  0  (statement  zero)  in  front  of 
star  name. 

EXAMPLE:  If  statement  name  is  jonathan,  type:  0  *jonathan 

if  you  use  a  statement  name  alone  as  an  ADDRESS  element  (without  *),  the 
system  will  randomly  search  for  any  statement  with  that  name.  Thus 
NEXTNAME  is  slower  but  more  predictable  when  two  statements  have  the  same 
name.  See  also:  searching,  STATEMENTNAME,  BRANCHNAME. 

NIC:  an  acronym  for  Network  Information  Center:  A  part  of  ARC,  the  NIC 
stimulates  use  and  interest  in  the  Network,  supports  communication  among 
scattered  research  teams,  provides  reference  about  Network  resources,  and  serves 
as  a  developmental  prototype  for  network  information  centers.  Reference  is 
offered  through  online  documentation  and  a  query  language  and  offline  through 
selected  mailing  of  printed  copies.  Communication  is  through  SENDMAIL  and 
through  special  online  files  maintained  for  ARC  groups.  See  also:  ARPANET. 

NLS-DDT:  a  dynamic  debugging  system  for  the  NLS  program  environment. 

for  commands  to  use  NLS-DDT:  5<?eset  NDDT  (PROGRAMS). 

NLS:  Online  System:  NLS  is  a  system  for  using  computers  to  help  in  work  based 
on  textual  information.  With  NLS  you  may  read,  write,  publish,  mail, 
collaborate,  calculate,  and  program,  among  other  things,  in  an  integrated  way 
augmented  by  the  computer.  The  command  language  allows  you  to  move  around 
in  and  modify  the  information  hierarchy.  NLS  groups  commands  into  subsystems 
for  related  tasks.  To  find  out  how  to  do  a  task  in  NLS,  see:  HOW. 

entering-NLS:  (How  to  get  NLS):  NLS  runs  as  a  subsystem  of  TENEX.  When  TENEX  is 
ready  for  commands,  you  will  see  an  at  sign  ("@")  at  the  margin.  Type  "NLS"  followed  by 
carriage  return.  If  you  use  a  group  directory,  NLS  will  ask  for  your  IDENT.  When  you  first 
enter  NLS,  the  system  loads  for  you  a  special  file  called  your  initial  file  and  you  are  in  the 
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BASE  subsystem.  Unless  you  have  altered  your  useroptions,  the  herald  of  the  BASE 
subsystem,  "BASE",  will  appear  at  the  left  margin.  Then  you  may  read  or  write  on  files.  See 
also:  Login,  username,  USEROPTIONS,  reading,  writing. 

leaving  NLS  to  TENEX:  To  return  to  the  TENEX  timesharing  system  from  NLS  use  the  Quit 
NLS  command.  After  that,  you  can  type  "con"  followed  by  carriage  return  at  the  TENEX 
herald  to  return  to  NLS.  To  break  contact  with  TENEX  entirely  use  the  Logout  command  in 
TENEX  or  NLS.  To  leave  NLS  anytime  for  an  excursion  in  TENEX,  use  the  Goto  TENEX 
command.  This  command  issues  to  you  a  second  copy  of  TENEX  called  "inferior  exec".  To 
return  from  this  second  copy  to  NLS,  use  the  TENEX  Quit  command. 

Systems  in  general:  See  systems. 

Information  hierarchy:  See  Information. 

Command  language  parameters:  See  Command. 

BASE  subsystem:  See  Base. 

Sendmaii  subsystem:  SeeSendmail. 

Useroptions  subsystem:  See  Useroptions. 

Programs  subsystem:  user  programming  software  See  Programs. 

Calculator  subsystem:  See  Calculator. 

TENEX:  See  TENEX. 

noiseword:  a  word  typed  by  the  system  to  help  you  understand  the  purpose  of  the 
command  and  what  input  is  expected  of  you.  Noisewords  always  appear  in 
parentheses.  You  can  turn  off  or  limit  noise  words  (as  well  as  lessen 

commandword  feedback)  with  Useroption’s  Feedback  command.  See  also: 
notation,  heralds,  prompts. 

Useroptions  Feedback  command:  See  feedback  (USEROPTIONS). 

nominals:  any  word  used  as  a  noun.  In  the  NLS  Base,  every  command  is  made 
up  of  a  verb  followed  by  a  nominal.  Some  of  the  most  common  nominals  found 
in  NLS  are: 

Character:  See  character. 

Word:  See  word. 

Number:  See  number. 

Visible:  See  visible. 

Invisible:  See  invisible. 

Text:  See  text. 

Link:  See  link. 

Statement:  See  statement. 

Branch:  See  branch. 

Group:  See  group. 

Plex:  Seeplex. 

File:  See  file. 

Directory:  See  directory. 

non-alphanumeric:  See  character. 


96 


Nl  S-K 


non-printing  characters  (invisible):  See  invisible. 

notation  for  command  syntax:  special  symbols  to  help  explain  commands. 
You  may  see  notation  for  command  syntax  when  you  type  questionmark,  as  the 
first  line  of  many  command  explanations,  in  prompts,  and  when  you  type 
<CTRL-S>.  Each  special  notation  is  described  below.  If  you  understand  the 
meanings  of  these  special  symbols,  you  can  learn  how  to  use  any  command  by 
reading  its  command  syntax. 

Commandwords:  First  Letter  Capitalized:  See  commandword. 

VARIABLES:  ALL  CAPITAL  LETTERS  See  VARIABLES. 

(noisewords):  words  in  parentheses:  See  noiseword. 

[optional]  things  in  square  brackets:  type  <CTRL-U>  See  optional. 

Icomments!  words  in  exclamation  marks  !not  part  of  command!:  See  also: 

comments  (SENDMAIL). 

<anglebrackets>:  a  notation  that  helps  to  depict  ...  See  anglebrackets. 

noun:  See  nominals. 

NULL: 

null  CONTENT  — TNLS  <CA>:  Type  a  command  accept  <CA>  if  you  want  nothing  in  the 
CONTENT. 

null  CONTENT — DNLS  <CTRL-N>:  If,  in  the  part  of  the  command  asking  for  for  CONTENT, 
you  want  to  specify  nothing,  use  either  of  the  following: 

—  typing  <  CTRL-N  > 

-typing  any  character  then  Backspace  Character  (BC)  and  Command  Accept, 
as  a  name  delimiter  (NULL):  See  name-delimiters. 

NUM:  number(s)  followed  by  an  OK  and  added  to  the  accumulator  in  the 

Calculator  subsystem.  Any  character  that  is  not  a  number  is  simply  ignored. 

number  as: 

Number:  a  special  string  of  digits,  used  chiefly  with  the  calculator  subsystem.  Numbers  may  be 
preceded  by  a  plus  or  a  minus  sign  and  may  include  decimal  points  and  commas  only  in 
certain  positions.  Pointing  to  any  character  position  in  the  number  will  serve  to  point  to  the 
whole  number. 

special  effects  editing  numbers.  When  replacing  a  number  with  the  Replace  Number 
command  that  is  smaller  than  the  original,  spaces  will  be  inserted  to  keep  the  right  side 
of  the  number  in  the  same  position.  Note  that  12345  in  789,12345,  is  a  legal  word  but 
not  a  legal  number  because  the  comma  is  not  in  a  legal  position;  and  in 
<journal- 12345,  >  12345  is  not  a  legal  number  because  there  are  two  minus  signs.  Also 
note  that  if  you  use  the  Number  commandword  to  edit  75  in  the  date  10-DEC-75,  the 
dash  after  DEC  will  be  carried  with  the  75.  If  you  try  to  Move  or  Copy  a  legal  number 
to  follow  an  entity  which  is  not  a  number,  you  will  get  the  message  "illegal  number" 
and  the  computer  will  not  do  the  edit. 

calculator  numbers:  See  numbers  (CALCULATOR). 

Number  Assign/Previously  ...:  The  Sendmail  subsystem  command  "Number  Assign"  shows 
you  the  number  of  your  current  item.  The  command  "Number  Previously"  allows  you  to  give 
a  number  that  you  have  already  reserved.  In  addition,  there  is  a  Reserve  command  elsewhere 
in  the  Sendmail  subsystem  for  getting  other  types  of  numbers.  See  also:  numbering 
(SENDMAIL). 
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Assign:  Number  Assign  OK:  The  Sendmail  subsystem  command  "Assign"  allows  you  to 
see  the  number  that  has  been  assigned  to  your  current  journal  item.  If  you  do  not  use 
this  command,  Sendmail  will  not  tell  you  the  number  of  your  item  until  you  see  it  in  the 
author  branch  of  your  INITIAL  file.  Use  Sendmail’s  Reserve  command  to  get  a  number 
you  can  use  at  a  later  time.  See  also:  journal-number. 

Journal  number:  See  number  (SENDMAIL). 

Journal  item:  See  item  (SENDMAIL). 

Sendmail  subsystem:  See  sendmail. 

Previously:  Number  Previously  (Reserved)  CONTENT  OK:  The  Sendmail  subsystem 
command  "Previously"  allows  you  to  specify  a  previously  reserved  number  for  the 
number  of  your  current  journal  item.  Use  Sendmail’s  Reserve  command  to  reserve  a 
number.  The  Send  command  will  be  carried  out  only  if  one  of  the  authors  or  the 
logged-in  user  has  previously  reserved  but  not  used  that  number.  You  must  use  the 
Sendmail  RFC  command  to  use  a  previously  reserved  RFC  number. 

The  Number  Assign  command:  See  number  assign  (SENDMAIL). 

The  Reserve  numbers  command:  See  reserve. 

The  Done  command:  See  done. 

The  RFC  command:  See  RFC. 

Journal  number:  See  number  (SENDMAIL). 

Numbering  system:  The  Sendmail  Journal  number  system  consists  of  a  single 
sequential  list  of  numbers  starting  from  1  and  counting  to  31000  as  of  July  1974. 
There  are  many  overlapping  subsets  of  these  numbers  (some  subcollections  have 
secondary  numbering  sequences)  which  have  various  ambiguous  and  synonymous 
names  in  common  usage.  All  of  the  numbers  in  the  sequential  list  are  called 
Catalog  Numbers.  Journal  Numbers  include  only  items  that  have  been  entered 
via  the  Sendmail  (formerly  Journal)  subsystem.  In  addition,  there  are  XDOC 
numbers  which  refer  to  external  documents  which  have  been  given  a  number  but 
have  not  been  entered  via  the  Sendmail  subsystem.  You  may  reserve  a  Journal 
number(s)  to  be  used  at  a  later  time  with  the  Sendmail  Reserve  command. 
Reserved  Journal  numbers  are  also  called  "Preassigned”  numbers. 

XDOC:  acronym  for  external  document  See  XDOC. 

Subcollections:  See  oubcollections. 

Reserving  a  number:  See  number  assign. 

Using  a  number:  See  number  previously  (SENDMAIL). 

numbers  (recognizable  to  the  Calculator): 

123456  -123456  123456- 

123.12  $123.00  .12345- 

123,456  ($1,123,123)  12,123. 123  + 

.1  .12-  0.11 
+  1 

You  may  also  treat  the  values  of  any  of  the  ten  accumulators  as  operands  with  the 
Use  Saved  (Accumulators)  command.  See  also:  Saved,  number,  accumulator. 
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0  ViewspeC:  frozen  statements  on  (DNLS  only):  "Display  the  frozen  statements." 
If  you  set  viewspec  o,  any  statements  that  have  been  set  aside  with  the  Freeze 
Statement  command  will  be  displayed  at  the  top  of  the  window,  separated  by  a 
dotted  line  from  the  rest  of  the  display;  if  none  have  been  frozen  only  a  dotted 
line  will  appear  (which  is  useful  with  horizontal  split  screens).  Viewspec  p  turns 
o  off. 

0  Viewspec:  user  sequence  generator  on:  "Turn  on  user-written  sequence 
generator."  Viewspec  P  employs  the  system’s  standard  sequence  generator  in 
lining  up  statements  for  output.  It  is  possible  (but  only  knowing  advanced  L10 
programming)  to  write  your  own  sequence  generator  program.  Viewspec  O,  if 
turned  on,  would  then  use  yours  instead  of  the  standard  one.  See  also: 
Sequence,  Capital-P. 

Obsoletes  (item  number(s))  CONTENT  OK:  The  Sendmail  Subsystem 
command  "Obsoletes"  places  a  note  in  the  header  of  the  journal  item  being  sent 
stating  that  the  item  number  you  specify  for  CONTENT  is  obsoleted  (replaced) 
by  this  item  and  the  fact  is  noted  in  the  indices.  There  is  no  further  use  of  this 
command  at  the  present  time. 

Offline  (item  --  located  at)  CONTENT  OK:  The  Sendmail  subsystem 
command  "Offline"  allows  you  to  mail  a  citation  for  and  give  a  number  to  an 
offline  item.  Use  the  CONTENT  selection  in  SENDMAIL  to  describe  the  offline 
location.  See  also:  xdoc. 

number:  See  number  (SENDMAIL). 

CONTENT:  See  content. 

OK:  command  confirmation:  Most  commands  must  be  terminated  by  one  of  three 
confirmation  functions:  CA  (Command  Accept  <  CTRL-D  > );  OKREPEAT 
<CTRL-B>;  or  OKINSERT  <CTRL-E>.  The  system  will  prompt  you  with 
"OK:  "  when  one  of  these  OK  functions  is  expected.  You  may  hit  a  CD 
(Command  Delete  <  CTRL-X  > )  at  any  time  in  a  command  (before  the  final  CA) 
to  stop  the  command.  See  also:  prompts,  CTRL,  CTRL-O. 

CA:  Command  Accept  See  CA. 

OK-COlon:  OK:  CA:  < CTRL-D >;  RPT:  <CTRL-B>;  OKINSERT:  <CTRL-E>;  CD: 
<  CTRL-X  > . 

When  prompting  is  on  and  you  have  finished  giving  a  command,  NLS  prompts  you  with 
"OK:".  It  expects  you  to  confirm  that  you  want  the  command  to  take  place  as  written.  CA, 
OKREPEAT,  or  OKINSERT  will  serve  as  confirmation. 
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OKINSERT:  <CTRL-E>:  Typing  the  character  for  OKINSERT,  <CTRL-E>,  at  the  end  of  a 
command  will  start  another  Insert  Statement  command.  This  allows  you  to  continue  to  insert 
statements  following  the  one  you  just  inserted  without  having  to  give  the  command  "Insert 
Statement"  again.  It  is  as  if  you  typed  CA,  Insert  Statement,  and  pointed  to  your  current 
location.  L:  will  appear  prompting  you  for  LEVEL-ADJUST  but  you  can  ignore  it  by  just 
starting  to  type.  OKINSERT  continues  to  repeat  until  you  type  a  CD.  Typing  another 
<CTRL-E>  while  in  repeat  mode  will  act  like  CA.  See  also:  OKREPEAT,  CTRL-character. 

LEVEL-ADJUST:  See  level -adjust. 

insert  Statement  command:  See  insert  statement. 

Making  some  other  key  work  like  <CTRL-E>:  See  control  (USEROPTIONS). 

OKREPhAT:  <CTRL-B>:  Typing  the  character  for  OKREPEAT,  <  CTRL-B  >  ,  at  the  end  of  a 
command,  will  execute  the  command  and  then  begin  to  repeat  the  same  command  from  the 
beginning.  Each  commandword  will  be  repeated  until  the  system  reaches  the  first  part  not  a 
commandword  that  you  can  specify.  Once  you  have  gotten  into  this  REPEAT  mode,  the  last 
command  will  be  repeated  no  matter  how  you  confirm  it,  until  you  type  <CTRL-X>.  In 
DNLS  press  down  and  release  the  two  right-most  mouse  buttons  for  OKREPEAT,  See 
OKINSERT. 

RPT:  OKREPEAT  prompt  SeeRPT. 

Trick  with  the  Execute  command:  You  may  use  the  Backspace  Character  function  to 
back  out  of  the  command  and  specify  another  command  but  remain  in  REPEAT  mode. 
You  may  also  use  this  feature  to  continue  the  use  of  "Execute"  in  another  subsystem. 
Follow  Execute  and  the  command  you  choose  with  <  CTRL-B  >  .  When  the  command 
repeats,  back  up  to  the  herald  using  <CTRL-A>,  and  then  specify  some  other  command 
in  the  normal  manner.  You  can  keep  on  this  cycle  indefinitely.  Command  Delete 
returns  you  to  the  first  subsystem.  See  also:  backspace. 

CD:  Command  Delete  See  CD. 

Note-If  a  TYPEIN  or  a  LEVEL-ADJUST  or  VIEWSPECS  or  an  ADDRESS  immediately 
precedes  OK,  its  terminator  serves  as  the  OK  character,  so  if  you  want  to  REPEAT  the 
command  or  get  into  INSERT  mode,  terminate  the  TYPEIN,  LEVEL-ADJUST,  VIEWSPECS, 
or  ADDRESS  with  the  OKINSERT  or  OKREPEAT  instead  of  CA. 

OLDFILELINK:  the  part  of  a  command  that  wants  you  to  specify  the  name  of  an 
existing  file  in  the  form  of  a  FILEADDRESS.  See  fileaddress . 

On:  to  be  on  a  statement  means  you  are  located  at  that  statement.  There  are  several 
things  you  can  turn  on  and  off  in  NLS.  See  also:  useroptions,  Set  Content 
(BASE),  viewspecs. 

Operands:  those  parts  of  a  command  you  specify  after  you  have  typed  the 

COMMANDWORDs  and  before  you  have  typed  the  OK  command  terminator. 
See  also:  COMMANDWORD,  OPERATORS,  OK.  The  operands  are  as  follows: 

DESTINATION:  See  DESTINATION. 

CONTENT:  See  CONTENT. 

SOURCE:  See  SOURCE. 

stars-in-brackets:  [**].  See  stars. 

LEVEL-ADJUST:  See  LEVEL- ADJUST. 

VIEWSPECS:  See  VIEWSPECS. 

ANSWER:  See  ANSWER. 
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operator:  See  commandword. 

Operator:  the  person  who  runs  the  computer.  You  may  see  her  logged  into  the 
system  as  a  user  named  "operator."  Frequently  it  is  useful  to  contact  the 
operator  for  help  with  problems,  particularly  recovery  from  bad  files. 

Operators:  Arithmetic  operators  are  always  entered  in  the  Calculator  subsystem 
directly  from  the  keyboard  and  followed  by  an  operand.  Valid  operators  include: 

NULL  or  <SP>  or  Add  or  +:  to  add  to  accumulator:  See  add. 

Subtract  or  to  subtract  from  accumulator:  See  subtract. 

Multiply  or  *  or  x:  to  multiply  to  the  accumulator:  See  multiply. 

Divide  or  /:  to  divide  into  the  accumulator:  See  divide. 

OPT:  and  [  ]:  are  prompts  for  OPTION  character  <CTRL-U>:  See  optional. 

Option:  See  optional. 

optional:  things  in  square  brackets:  type  <CTRL-U>  to  get  in  an  option  mode: 
There  are  some  optional  parts  in  commands  that  won’t  be  available  unless  you 
specifically  ask  for  them.  Type  the  character  <CTRL-U>  (OPTION  character) 
when  prompted  by  something  in  square  brackets  [**]  or  OPT:  ,  and  then  type 
questionmark  to  see  the  part  that’s  between  the  squarebrackets.  See  also: 
prompts,  control. 

options  vs  alternatives:  See  alternatives. 

origin:  Statement-Statement  zero:  statement  0  (zero)  that  is  found  in  every  file.  It 
is  the  structural  source;  one  level  above  the  first  level  statements  (numbers  1,  2, 
etc.  in  the  illustration).  The  system  writes  and  maintains  the  following 
information  in  the  origin  statement:  <  FILEADDRESS,  DATE,  TIME,  IDENT 
(of  last  person  to  update  the  file),  and  ;  ;  ;  ;  (four  semicolons).  See  also:  header, 
statementnumber. 

modifying  the  origin  Statement:  You  can  also  modify  the  origin  statement.  You  can  add 
output  processor  directives  and  the  AccessList  for  a  private  file  to  the  origin  statement. 

AccessList:  See  Set  NLS  Private. 

directives:  See  directives. 

Output:  In  general  output  is  the  product  that  leaves  a  computer  system.  In  the 
NLS  world  it  is  most  often  printed  paper,  but  may  also  be  tapes  containing  files 
or  files  shipped  by  electronic  means  to  other  computer  systems.  Output  from 
NLS  usually  means  conversion  to  some  sequential  form. 

The  command  "Output  Printer"  sends  items  through  what  is  called  the  Output  Processor.  In  the 
BASE  subsystem,  Load  File  userguides,  locator,.  It  will  take  you  to  the  Output  Processor 
Userguide.  See  also:  hardcopy. 

Assembler:  Output  Assembler  File/Append  CONTENT  OK:  The  command  "Output 

Assembler  File/Append"  allows  you  take  an  NLS  file  holding  assembly  language  code  in  a 
certain  format  and  copy  or  append  it  to  a  sequential  file  suitable  for  the  assembler. 

TNLS  example: 

BASE  C:  Output  C:  Assember  file  T:  prog 

OK: 
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Output  for  Assembler  in  Progress 
BASE  C: 

COM:  Output  (to)  COM  OK:  The  command  "Output  (to)  COM"  allows  you  to  produce  a 
sequential  file  formatted  for  Computer  Output  to  Microfilm.  The  command  creates  a  job 
identified  by  your  initials  in  the  directory  COM.  Output  Processor  directives  will  be  considered 
in  formatting  the  file.  Printing  begins  from  the  statement  where  you  are  located.  The 
compiled  file  should  be  placed  in  the  <COM>  directory  (as  it  is  when  you  just  say  OK: 
without  specifying  any  of  the  below),  then  contact  Dean  Meyer,  Dirk  van  Nouhuys  or  Ann 
Weinberg  at  SRI-ARC.  See  <userguides,  op-guide,  1>. 

TNLS  example: 

BASE  C:  Output  C:  COM  OK: 

Processing  Output 

BASE  C: 

Append:  Output  (to)  COM  Append  (to  file)  CONTENT  OK:  The  command  "Output  (to) 
Com  Append"  allows  you  to  produce  a  sequential  file  formatted  for  Computer  Ouput  to 
Mirofilm  and  appends  it  to  the  file  at  the  FILEADDRESS  you  specify  for  CONTENT. 

File:  Output  (to)  COM  File  (to  file)  CONTENT  OK:  The  command  "Output  (to)  COM 
(to  file)"  allows  you  to  Create  a  sequential  file  formatted  for  Computer  Output  to 
Microfilm  at  the  FILEADDRESS  you  specify  for  CONTENT.  It  does  not  copy  the  file 
to  the  printer. 

Copies:  Output  (to)  COM  Copies  CONTENT  OK:  The  command  "Output  (to)  COM 
Copies"  allows  you  to  specify  the  number  of  copies  for  CONTENT  that  will  be  printed 
on  the  line  printer.  No  file  will  be  created  in  your  directory.  See  also:  output  com. 

Test:  Output  (to)  COM  Test  OK/File...  The  command  "Output  (to)  COM  Test  formats 
the  file  and  places  special  symbols  in  it  to  represent  what  the  COM  version  would  look 
like  on  a  line  printer  and  prints  it  on  the  printer  if  you  type  an  OK.  Instead  of  OK,  you 
can  say  "File"  and  have  the  COM  test  appear  in  the  file  with  the  fileaddress  you  specify 
for  CONTENT. 

Output  (to)  COM  Test  File  CONTENT  OK: 

Journal:  Output  Journal  (quickprint)  OK:  The  command  "Output  Journal"  looks  for  a 

statement  named  "journal",  such  as  in  your  initial  file.  Then  it  prints  one  copy  on  your 
computer’s  line  printer  of  each  journal  citation  followed  by  the  complete  item  (except  for  the 
origin  statement  in  a  file).  To  see  only  those  items  you  have  not  already  seen,  you  must  move 
the  items  you  have  seen  out  of  the  branch  named  "journal".  See  also:  journal, 

statementname,  Move  STRUCTURE,  sendmail,  initial. 

TNLS  example: 

BASE  C:  Output  C:  Journal  Quickprint  OK: 

Output  Journal  Quickprint  in  Progress 
BASE  C: 

Append:  Output  Journal  (quickprint)  Append  (to  file)  CONTENT  OK:  The  command 
"Append  Output  Journal  (quickprint)  Append"  appends  the  sequential  file  generated 
from  journal  items  to  the  sequential  file  you  specify  for  CONTENT. 

Copies:  Output  Journal  (quickprint)  Copies  CONTENT  OK:  The  command  "Output 
Journal  (quickprint)  Copies"  prints  on  the  line  printer  as  many  copies  as  you  specify  for 
CONTENT.  This  command  prints  from  the  file  you  have  loaded  anything  you  have  in  a 
branch  named  "journal."  Each  journal  item  and  the  complete  text  of  any  links  that  are 
shown  are  printed. 

File:  Output  Journal  (quickprint)  File  (to  file)  CONTENT  OK:  The  command  "Output 
Journal  (quickprint)  File"  inserts  the  journal  items  as  a  sequential  file  named  whatever 
you  specify  for  CONTENT. 

Printer:  The  command  "Output  Printer"  will  produce  a  sequential  file  in  directory  <  Printer  > 
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formatted  for  the  line  printer.  Output  Processor  directives  will  be  considered  in  formatting  the 
file.  Printing  begins  from  the  statement  were  you  are  located.  Any  files  in  the  <  PRINTER  > 
directory  will  be  printed  then  deleted.  If  you  wish  to  save  the  print  file,  specify  a  filename  in 
another  directory  and  copy  it  to  the  <  PRINTER  >  directory  when  you  want  a  copy.  See 
(userguides,  op-intro,  3).  See  also:  sequential,  FILEADDRESS. 

TNLS  example: 

BASE  C:  Output  C:  Printer  OK: 

Processing  Output 

BASE  C: 

OK:  Output  Printer  OK:  The  command  "Output  Printer"  prints  it  on  the  line  printer. 

Copies:  Output  Printer  Copies  CONTENT  OK:  The  command  "Output  Printer  Copies" 
prints  on  the  line  printer  as  many  copies  as  you  specify  for  CONTENT  . 

File:  Output  Printer  File  (to  file)  CONTENT  OK:  The  command  "Output  Printer  File" 
creates  a  sequential  file  named  whatever  you  specify  for  CONTENT. 

Append:  Output  Printer  Append  (to  file)  CONTENT  OK:  The  command  "Output  Printer 
Append"  appends  the  processed  file  to  the  sequential  file  you  specify  for  CONTENT. 

See  also: 

processor:  Output  Processor:  The  NLS  procedures  that  processes  NLS  files  into 

sequential  files  suited  to  drive  devices  that  produce  hardcopy. 

Quickprint:  Output  Quickprint  OK:  The  command  "Output  Quickprint"  prints  hardcopy  at  the 
line  printer  of  the  computer  where  you  are  logged  in.  It  observes  viewspecs  in  force  but  not 
output  printer  directives,  which  remain  as  text  in  the  printout.  The  printout  is  paginated  and 
bears  the  file  header.  Quickprint  runs  more  than  10  times  faster  than  Output  Printer.  Output 
Quickprint  compiles  your  file  to  a  printer  file  just  like  the  view  you  would  get  with  a  Print 
command  but  paginated.  Printing  begins  from  your  current  location.  Intead  of  OK:  you  can 
specify  one  of  the  following  alternatives. 

TNLS  example: 

BASE  C:  Output  (to)  C:  Quickprint  OK: 

Output  Quickprint  in  Progress 

BASE  C: 

Append:  Output  Quickprint  Append  (to  file)  CONTENT  OK:  The  command  "Output 
Quickprint  Append"  allows  you  to  specify  for  CONTENT  the  FILEADDRESS  of  a 
sequential  file  to  which  your  quickprint  is  to  be  appended. 

Copies:  Output  Quickprint  Copies  CONTENT  OK:  The  command  "Output  Quickprint 
Copies"  allows  you  to  specify  the  number  of  copies  to  be  printed  for  CONTENT. 

File:  Output  Quickprint  File  CONTENT  OK:  The  command  "Output  Quickprint  File" 
allows  you  to  save  a  print  file  after  it  has  been  printed.  You  specify  a  FILEADDRESS 
for  CONTENT  and  when  you  want  to  print  it  again,  you  copy  the  file  to  the  <  Printer  > 
directory.  Any  files  in  the  <  PRINTER  >  directory  will  be  printed  and  then  deleted. 

NO:  Output  Quickprint  No  (headers)  OK/C:  The  command  "Output  Quickprint  No" 
prints  your  file  so  that  the  only  thing  appearing  at  the  top-right  of  each  page  is  "Page 
#".  Instead  of  OK,  you  may  also  specify  these  command  words: 

Append:  Output  Quickprint  No  (headers)  Append  (to  file)  CONTENT  OK: 

The  command  "Output  Quickprint  No  (headers)  Append"  allows  you  to  specify  a 
sequential  file  to  which  your  quickprint  is  to  be  appended.  CONTENT  wants  you 
to  give  the  FILEADDRESS  of  a  sequential  file. 

Copies:  Output  Quickprint  No  (headers)  Copies  CONTENT  OK:  The  command 
"Output  Printer  No  (Header)  Copies"  allows  you  to  specify  the  number  of  copies 
to  be  printed.  Content  wants  you  to  give  a  number. 

File:  Output  Quickprint  No  (headers)  File  CONTENT  OK:  The  command  "Output 
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Quickprint  No  (headers)  File  allows  you  to  save  a  print  file  (that  has  no  headers) 
after  it  has  been  printed.  You  specify  a  FILEADDRESS  for  CONTENT  and 
when  you  want  to  print  it  again,  you  copy  the  file  to  the  <  Printer  >  directory.  Any 
files  in  the  <  PRINTER  >  directory  will  be  printed  and  then  deleted.  If  you  wish  to 
save  the  print  file,  specify  a  FILEADDRESS  for  CONTENT  and  copy  it  to  the 
<  PRINTER  >  directory  whenever  you  want  a  copy. 

Remote:  Output  Remote  (printer  —  TIP):  The  command  "Output  Remote"  will  compile  a  print 
file,  considering  directives,  and  send  it  to  a  printer  on  a  network  TIP.  Remote  printing  uses  a 
printer  connected  to  a  TIP  at  your  site.  You  must  supply  the  number  of  an  available  TIP  port 
to  the  command.  You  may  choose  not  to  send  form  feeds  (page  breaks);  they  may  be 
simulated  with  line  feeds,  or  you  can  send  no  page  breaks  at  all.  You  may  have  the  printer 
wait  after  each  page  if  you  like.  You  may  have  it  wait  to  start  until  you  say  go. 

TNLS  example: 

BASE  C:  Output  C:  Remote  printer--TIP  T:  radc-tip 
Port  T:  4 

Send  Form  Feeds?  C:  Yes 
Wait  (at)  page  breaks?  C:  No 
Go?  CA:/C: 

Output  Remote  printer  in  Progress 
BASE  C: 

formfeed:  5ee formfeed . 
linefeed:  5ee<LF>. 

Sequential:  Output  Sequential. 

TNLS  example: 

BASE  C:  Output  C:  Sequential  C:  File  T:  buz 
OK: 

Output  Sequential  in  Progress 
BASE  C: 

Append:  Output  Sequential  Append  (to  file)  CONTENT  OK:  The  command  "Output 
Sequential  Append"  appends  the  sequential  output  from  your  file  to  the  sequential  file 
whose  FILEADDRESS  you  specify  for  CONTENT.  An  NLS  file  may  be  converted  to  a 
sequential  text  file  with  the  Output  Sequential  command.  The  filename  extension  will 
default  to  "TXT". 

File:  Output  Sequential  File  CONTENT  OK:  The  command  "Output  Sequential  File" 
converts  an  NLS  file  to  a  sequential  text  file.  The  filename  extension  will  default  to 
"TXT".  See  also:  FILEADDRESS. 

Terminal:  Output  Terminal  OK:  /File  ...  The  command  "Output  Terminal"  will  process  a  file 
considering  directives,  like  the  Output  Pnnter  command,  but  it  will  print  at  your  terminal. 
You  may  choose  not  to  send  form  feeds  when  a  new  page  starts;  they  may  be  simulated  with 
line  feeds.  You  may  have  the  output  wait  after  each  page  if  you  like.  "Output  Terminal  File" 
will  create  a  sequential  file  properly  formatted  that  may  then  be  sent  via  sndmessage,  copied 
over  the  ARPANET,  or  to  the  printer.  <CTRL-0>  will  abort  the  printing.  See  also: 
commands,  output  printer,  sequential. 

TNLS  example: 

BASE  C:  Output  C:  Terminal  Send  Form  Feeds?  Yes 
Wait  (at)  page  breaks?  No 
Go?  Yes 

Output  Terminal  in  Progress 
BASE  C: 

Syntax:  Output  Terminal  OK:  (send  form  feeds?)  CHOICE  (wait  at  page  break?)  ANSWER 
(Go?)  START 
CHOICE  =  Yes 
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or  No  (simulate?)  ANSWER 
START  =  Yes  or  OKIsame  as  Yes! 

or  No  (Type  CA  when  ready,  CD  to  abort)  <  SP  > 

ownership:  See  privacy. 
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p  ViewspeC:  frozen  statements  off  (DNLS  only):  "Don’t  display  the  frozen 
statements."  This  viewspec  turns  off  viewspec  o;  the  frozen  statements  and/or 
dotted  line  in  the  window  will  disappear,  but  this  does  not  unfreeze  the  statements 
and  they  will  appear  again  upon  setting  Viewspec  o.  The  command  "Release" 
unfreezes  statements.  This  is  a  default  viewspec. 

P  Viewspec:  user  sequence  generator  off:  "Do  not  use  user-written  sequence 
generator  program."  This  viewspec  returns  control  to  the  system's  standard 
sequence  generator  in  lining  up  statements  for  output.  Viewspec  O  switches  to  a 
user-written  sequence  generator  program  (writing  one  requires  knowing  advanced 
L 10  programming).  This  is  a  default  viewspec.  See  also:  sequence,  Capital-O. 

Packet:  strings  of  bits  bounded  by  routing  information  which  form  the  transmission 
units  in  the  ARPA  net. 

pages: 

in  TNLS  Print  command:  See  E. 

in  Output  Quickprint:  See  output  quickprint. 

online  (Jump  to  Next):  5eenext. 

the  Useroptions  subsystem  "Printoptions  Page"  command:  Seepage  (USEROPTIONS). 

pages  On  the  disk:  Computer  (disk)  storage  space  is  divided  into  disk  pages  of  512  36-bit 
words.  These  equal  approximately  one  typewritten  page  (or  about  250-300  English  words). 
The  amount  of  text  in  a  computer  page  can  be  roughly  equal  to  the  amount  of  text  on  a  page 
of  paper  but  they  are  two  different  things.  To  find  out  how  many  disk  pages  are  allocated  and 
used  by  a  file,  use  the  Show  File  Size  command.  To  find  out  how  many  disk  pages  are 
allocated  and  used  by  a  directory,  use  the  size  option  in  the  Show  Directory  command. 

command  to  Show  File  Size:  See  Show  File  Size. 

command  to  Show  Disk  space  status:  See  Show  Disk. 

pagination:  The  output  from  your  terminal  when  the  Print  commands  are  used 
will  be  divided  into  pages  if  viewspec  E  is  on.  Pages  are  numbered,  and  a  cutting 
line  consisting  of  — ’s  is  generated  before  the  start  of  a  new  page.  You  can 
control  the  margins  and  page  sizes  with  the  Printoptions  command  in  the 
Useroptions  subsystem.  See  also:  Capital  —  E,  Printoptions  (USEROPTIONS). 

paragraph:  See  statement. 

parens  ()  (problems  with  using):  Since  parentheses  are  legal  characters  in  a 
Filename,  placing  two  links  delimited  by  parens  next  to  each  other  not  separated 
by  a  space  causes  an  irresolvable  confusion.  Also,  it  is  possible  for  parenthetical 
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clauses  in  a  statement  to  become  confused  with  links.  If  you  are  using  the  Link 
entity  while  editing  a  link  that  does  not  have  proper  syntax,  it  is  possible  to  end 
up  editing  the  parenthetical  clause  instead.  To  avoid  confusion,  we  suggest  you 
use  angle-brackets  <  >  instead  of  parentheses  in  links. 

partial  copy:  now  referred  to  as  Modification  file.  See  also:  search.  See 
modification. 

Password:  the  string  of  characters  necessary  for  the  computer  to  recognize  you  at 
login  and  necessary  for  connecting  to  the  directory  of  another  user.  When  you 
type  a  password,  no  characters  appear.  There  is  a  CHANGE  PASSWORD 
command  in  TENEX.  See  also:  IDENT. 

pattern:  content-analyzer  pattern:  A  content-analyzer  pattern  is  different  from  a 
content-analyzer  program  in  that  it  does  not  include  all  of  the  lines  of  L10  code 
necessary  for  the  program.  It  just  consists  of  a  string  of  character  and  special 
symbols  that  specify  what  to  look  for.  When  a  content-analyzer  pattern  is 
specified  by  the  "Set  Content  To"  command  in  the  BASE  subsystem  or  by 
placing  the  pattern  between  semi-colons  in  the  viewspec  field  of  a  link,  the  proper 
lines  of  L10  code  are  automatically  called  to  make  the  pattern  work  as  a 
content-analyzer  program.  For  the  elements  of  content-analyzer  patterns,  see  the 
L10  User's  Guide.  COMPARE  content-analyzer  program. 

The  Set  Content  (pattern)  command  in  Base:  5eeset  content. 

content-analyzer  patterns  in  the  viewspec  field  of  a  link:  See  semicolons. 

Square-brackets  in  content-analyzer  patterns:  See  Square- brackets. 

.PC;  designates:  this  file  is  a  modification  file:  See  modification. 

PDP-10:  Since  1970,  all  versions  of  NLS  have  run  on  Digital  Equipment 

Corporation’s  (DEC)  PDP-10  computer  under  the  TENEX  time-sharing  system 
developed  at  BBN.  The  asynchronous  arithmetic  Processor  has  a  1 -microsecond 
cycle  and  uses  36-bit  words  paged  in  a  BBN  paging  box  into  512-word  pages. 

period: 

in  an  address  expression:  See  POSITION, 
in  filenames:  See  filename, 
as  a  command:  See  period  . 

period:  [TNLS  only]:  Typing  the  period  key  at  the  herald  of  a  subsystem  prints 
your  statement  number,  or  SID  if  viewspec  I  is  on,  followed  by  a  number 
indicating  how  many  characters  you  are  to  the  right  of  the  beginning  of  the 
statement.  COMPARE  address  slash. 

TNLS  example: 

BASE  C:  .  =  2d  +12 
BASE  C: 

Playback  Record  (of  session  from  file)  CONTENT  (simulate  recorded  timing?) 
ANSWER  OK: 

The  command  "Playback  Record"  will  pass  control  to  the  file  you  recorded  on 
and  precisely  the  same  commands  will  be  seen  and  executed  on  the  file  you  were 
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working  on  as  during  the  control  session.  This  will  happen  in  approximately  the 
same  timing  if  you  ANSWER  with  a  y  (for  yes).  If  you  ANSWER  with  an  n  (for 
no),  the  session  will  playback  as  fast  as  it  can.  CONTENT  wants  you  to 
TYPEIN  or  point  to  the  FILEADDRESS  of  the  file  you  recorded  on. 

TNLS  example: 

BASE  C:  Playback  C:  Session  (from)  file  T:  rf 

[commands  recorded  on  file  will  be  executed  here] 

BASE  C: 

Effects:  you  should  be  careful  that  everything  is  set  up  properly  when  you  playback  the  session. 

If  you  get  into  trouble.  <CTRL-0>  stops  the  playback. 

Start  Record  command:  See  start. 

PleX:  a  specified  branch,  plus  all  the  other  branches  having  the  same  source.  In  the 
illustration,  to  be  found  under  I,  the  plex  defined  (and  addressed)  by  statement  3a 
consists  of  branches  3a,  3b,  and  3c  (i.e.  statements  3a,  3b,  3c,  3c  1 ,  and  3cla). 
Plex  3b  and  3c  are  exactly  the  same  as  3a. 

illustration  of  file  structure:  See  illustration. 

Plex  (at)  SOURCE  OK:  The  Sendmail  Subsystem  command  "Plex"  allows  you  to  send  a  Plex. 

Specify  the  Plex  to  be  mailed  with  a  SOURCE  specification.  VIEWSPECS  do  not  matter. 

Plex:  See  plex. 

SOURCE:  See  source. 

plus  command:  +  :  See  add. 

Plus:  +  in  addresses:  See  stringposition , 

point:  used  as  a  noun  to  refer  to  a  character  in  a  line, 
used  as  a  verb  to  specify  a  character  in  a  line. 


Pointing  to  information:  addressing  and  bugging:  moving  to  a  specific  character 
within  a  file.  You  point  in  this  way  whenever  a  command  asks  for  an  ADDRESS 
(prompts  you  with  A:).  In  DNLS,  you  can  also  point  by  bugging  with  the  mouse. 
If  a  link  appears  in  the  text  of  a  file,  you  may  point  at  the  link  and  then  indicate 
to  the  system  that  you  want  to  go  to  the  place  named  in  the  link.  See  also: 
information . 

ADDRESS:  See  address. 

locating  your  position  in  a  file:  See  locating. 

bugging:  See  bug. 

Group-Text:  pointing  See  Group-Text . 

Trick:  See  Trick. 

Portrayal  Generator:  The  NLS  code  that  creates  something  formatted  for  view 
by  a  human. 

POSITION:  in  and  among  files  (preceded  by  a  period):  These  infile  address 

elements,  preceeded  by  a  period,  move  you  in  relation  to  your  current  location  in 
the  direction  that  corresponds  to  the  character  you  type.  A  number  before  any  of 
these  letters  indicates  the  number  of  moves  (default  for  number  is  1). 
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.b  back:  See  back. 

.c  next  occurrence  of  content:  See  contentaddress. 

.d  down:  See  down . 

.e  end:  See  end. 

.fr  file  return:  Seefr. 

.h  head:  See  head. 

.1  link:  See  link. 

.n  next:  See  next. 

.o  origin:  See  origin. 

.p  predecessor:  See  predecessor. 

.r  return:  Seed. 

.s  successor:  See  successor. 

.t  tail:  See  tail. 

■  U  up:  See  up. 

.w  next  occurrence  of  word:  See  contentaddress. 

predecessor:  the  statement  preceding  a  given  statement  at  the  same  level  and 
having  the  same  source.  In  the  illustration,  the  predecessor  of  3c  is  3b;  statement 
1  is  the  predecessor  of  2  (which  is  called  the  successor).  Statements  either  have 
one  predecessor  or  none.  "Head”  Statements  such  as  the  origin  statement  and 
statement  1  never  have  predecessors.  See  also:  illustration. 

Print  (in  TNLS):  The  TNLS  command  "Print"  types  at  your  terminal  what  you 
specify. 

File:  Print  File  OK:  The  command  "Print"  prints  your  entire  file  with  default  viewspecs  without 
affecting  your  current  viewspecs  or  your  location.  To  select  a  starting  point  and  view  of  a  file 
for  printing,  use  the  Print  STRUCTURE  command.  See:  Print  STRUCTURE,  Print  Rest. 

Effects:  Typing  <CTRL-0>  will  stop  the  printing.  After  execution,  you  are  in  the  same 
statement  you  were  when  you  started  this  command.  You  may  have  TNLS  paginate 
your  output  with  any  print  command;  See  also:  CTRL,  pagination. 

Journal:  Print  Journal  (mail)  OK:  The  command  "Print  Journal"  will  look  for  a  statement 
named  "journal",  as  in  your  initial  file.  Then  it  prints  at  your  terminal  each  journal  citation 
followed  by  the  complete  item.  To  only  get  those  items  you  have  not  already  seen,  you  must 
move  the  items  you  have  seen  out  of  the  branch  named  "journal".  See  also:  statementname, 
Move  STRUCTURE,  sendmail,  citation,  item,  Output  Journal. 

Rest:  Print  Rest  OK:  The  TNLS  command  "Print  Rest  OK"  will  print  the  rest  of  your  loaded 
file,  starting  with  the  statement  you  are  currently  at.  This  command  will  not  affect  your 
location  or  your  viewspecs.  To  select  a  starting  point  and  view  of  a  file  for  printing,  use  the 
Print  STRUCTURE  command.  Typing  <  CTRL-0  >  will  stop  the  printing.  See:  Print 
STRUCTURE,  Print  File. 

STRUCTURE:  Print  STRUCTURE  (at)  DESTINATION  VIEWSPECS  OK:  This  group  of 
"Print"  commands  prints  at  the  terminal  the  particular  STRUCTURE  in  a  file  you  specify, 
according  to  the  viewspecs  you  give  to  control  the  format  of  the  printout.  If  you  give  no 
viewspecs,  your  current  viewspecs  will  control  printing. 

TNLS  example: 

BASE  C:  Print  CA:/C:  C:  Branch  (at)  A:  alice 

V:  m 
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3  (alice)  The  Walrus 

3a  "The  time  has  come,"  the  Walrus  said, 

3b  "To  speak  of  many  things, 

3bl  Of  shoes  and  ships  and  ceiling  wax, 

3b2  of  cabbages  and  kings, 

3b3  Of  why  the  sea  is  boiling  hot, 

3b4  And  whether  pigs  have  wings." 

BASE  C: 

Effects:  Typing  <CTRL-0>  will  stop  the  printing.  After  execution,  you  will  be  at  the  first 
character  of  the  first  statement  printed,  i.e.,  the  statement  you  were  in  when  you  started 
this  command.  Any  viewspecs  you  entered  remain  in  effect  until  you  change  them  again. 

STRUCTURE:  Statement,  Branch,  Plex,  or  Group:  See  STRUCTURE. 

See  also:  Output,  viewspecs,  STRUCTURE,  CTRL. 

printer:  The  directory  "printer"  contains  files  that  are  being  or  are  waiting  to  be 
printed  on  your  computer's  line  printer.  If  you  accidentally  print  something  big 
and  cannot  delete  and  expunge  it  from  this  printer  directory,  notify  your 
computer's  operator  to  halt  the  printer.  See  also:  output. 

printer:  printing  on  your  computer’s  line  printer:  The  Output  Processor  subsystem 
allows  users  to  format  printed  documents.  You  may  control  page  size,  position  of 
text,  indentation,  numbering,  headers,  footers,  and  many  other  features  through 
embedded  directives.  To  learn  the  directives,  read  the  Output  Processor  User 
Guide.  The  Output  Processor  converts  NLS  files  either  to  hardcopy  at  a  line 
printer  or  to  files  printable  later  on  printers  that  accept  ASCII  II  sequential  files. 
See  also:  ARC,  output. 

Output  Quickprint  command:  See  Output  Quickprint. 

Output  Printer  command:  See  Output  Printer. 

Output  Journal  Quickprint  command:  See  Output  Journal. 

remote:  printing  at  a  TIP:  See  Output  Remote. 

COM:  an  acronym  for  Computer  Output  to  Microfilm  5eeC0M. 

Problems  with  some  Printers:  Certain  printers  require  adjustments  in  page  size  by  means  of 
directives  on  special  processes  to  delete  control  characters.  If  you  run  into  trouble  with  the 
way  your  printer  presents  files  that  have  passed  through  the  Output  Processor,  report  the 
problem  to  feedback. 

printing  characters  (visible):  !"#$%&’()*  -f,-./0l23456789: 

;  <  =  >  @ABCDEFGHIJKLMNOPQRSTUVWXYZ[\] 
f  -  abcefghijklmnopqrstvwxyz. 

printing  on  your  terminal:  TNLS  can  print  at  your  terminal  through  two 
groups  of  commands  which  allow  you  more  or  less  formatting.  1)  The  Print 
commands  allow  simple  formatting,  such  as  pagination.  Printing  format  is  also 
controlled  by  Viewspecs.  2)  Output  Printer  uses  over  two  hundred  directives  that 
give  you  essentially  a  printer’s  control  of  layout.  Read  the  Output  Processor 
Users’  Guide.  See  also:  printing,  printer,  reading,  pointing. 

pagination:  See  pagination. 

Print  commands  in  BASE  subsystem.  See  Print. 

output  commands:  See  Output. 
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formatting  viewspecs:  See  formatting. 

Printoptions  PRINTSPECS  CONTENT  OK:  The  Useroptions  subsystem 
command  "Printoptions"  allows  you  to  specify  the  number  of  spaces  for  level 
Indenting  and  Tab  stop  settings.  You  can  set  the  left  and  right  margins  used  for 
TNLS  Print  commands.  You  can  specify  bottom  margin  and  page  size  used  at 
your  terminal  when  pagination  (viewspec  E)  is  on  in  the  Print  commands. 

related  commands:  See  also:  Print,  Show  Printoptions  (USEROPTIONS),  Reset  Printoptions 
(USEROPTIONS). 

PRINTSPECS: 

Right:  Printoptions  Right  (margin  is  column)  CONTENT  OK:  The  Useroptions  subsystem 
command  "Printoptions  Right  (margin  is  column)  allows  you  to  specify  a  Number  for  the 
column  where  your  printing  should  stop  at  the  right  margin  of  the  page.  CONTENT  wants  a 
specific  Number.  This  affects  both  paginated  output  (when  viewspec  E  is  on)  and  regular 
TNLS  output  immediately  upon  using  the  TNLS  Print  commands.  See  also:  pagination,  E 
Viewspec. 

Left:  Printoptions  Left  (margin  is  column)  CONTENT  OK:  The  Useroptions  subsystem 

command  "Printoptions  Left  (margin  is  column)"  allows  you  to  specify  a  Number  for  the 
column  where  your  printing  should  start  at  the  left  margin  of  the  page.  CONTENT  wants  a 
specific  Number.  This  affects  both  paginated  output  (when  Viewspec  E  is  on)  and  regular 
TNLS  output  immediately  upon. using  the  TNLS  Print  commands.  See  also:  pagination,  E 
Viewspec. 

Bottom:  Printoptions  Bottom  (margin  is  line)  CONTENT  OK:  The  Useroptions  subsystem 
command  "Printoptions  Bottom  (margin  is  line)"  allows  you  to  specify  a  Number  for  the 
number  of  lines  from  the  top  of  the  page  down  to  where  the  printing  will  stop  for  that  page. 
CONTENT  wants  a  specific  number.  This  takes  effect  immediately  upon  using  the  TNLS 
Print  commands  whenever  Viewspec  E  is  on.  See  also:  pagination,  E  Viewspec. 

Page:  Printoptions  Page  (size  is  (lines))  CONTENT  OK:  The  Useroptions  subsystem  command 
"Printoptions  Page"  allows  you  to  specify  a  number  for  CONTENT  for  the  number  of  lines 
from  the  top  of  the  page  to  the  bottom  of  the  page  (the  place  below  the  page  numbers  where 
dashes  mark  a  page  break).  This  takes  effect  immediately  upon  using  the  TNLS  Print 
commands  whenever  viewspec  E  is  on.  See  also:  pagination,  E  Viewspec. 

Indenting:  Printoptions  Indenting  (per  level)  CONTENT  OK:  The  Useroptions  subsystem 
command  "Printoptions  Indenting"  allows  you  to  control  the  indenting  of  levels  of  NLS 
heirarchical  structure.  CONTENT  wants  a  Number  for  the  spaces  each  level  will  be  indented 
from  the  preceding  level.  This  takes  effect  immediately.  See  also:  level . 

Tab:  Printoptions  Tab  (stop  settings)  CONTENT  OK:  The  Useroptions  subsystem  command 
"Printoptions  Tab"  allows  you  to  set  the  column  locations  where  TAB  (as  a  regular  invisible 
character,  not  a  command)  will  take  you.  (Warning:  the  use  of  TABs  often  causes  trouble 
when  moving  from  one  medium  of  output  to  another.)  You  are  not  allowed  more  than  9 
tabstops  per  line.  A  tabstop  cannot  be  set  in  column  1 . 

CONTENT  wants  one  of  the  following  forms: 

(1)  t  t  t  t  t  t  t  t 

where  the  t’s  are  separated  by  spaces  to  the  proper  position 
for  the  tab  stops.  A  tabstop  cannot  be  set  in  column  1. 

(2)  8,16,24,32,40,48,56,64,72 

where  the  number  represents  the  column  position  (starting 
from  1  not  0)  for  the  next  tab  stop. 

Problems  with  tabs  in  NLS:  Tabstops  cannot  be  set  for  an  online  file.  Instead,  the 
tabstops  you  set  will  affect  any  and  all  files  you  read.  You  can  use  the  Output  Printer 
directive  "TABSTOPS"  to  specify  the  stops  in  specific  "Output  Printed"  files,  but  they 
will  not  appear  correctly  in  online  or  "Output  Quickprinted"  files  unless  the  reader  uses 
the  Useroptions  subsystem  Printoptions  Tab  command  to  set  his  tabstops  to  be  the  same 
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as  those  set  in  the  TABSTOPS  directive.  Other  problems  with  the  use  of  tabs  in  NLS 
stem  from  a  change  in  structure.  When  a  statement  formatted  for  one  level  is  moved  to 
a  lower  level,  it  is  automatically  indented  3  spaces.  This  can  cause  a  tab  to  be  moved 
past  its  intended  stop  and  unintentionally  go  to  the  next  stop  (destroying  your  format). 
There  is  no  clean  way  to  convert  tabs  into  spaces.  A  tab  located  after  your  last  tabstop 
setting  generates  an  error  message.  We  do  not  recommend  using  TABS  to  format  for 
normal  NLS  purposes. 

privacy:  To  use  TENEX,  you  must  know  a  (secret)  password.  (NLS  recognizes 
you  by  an  independent  IDENT  associated  with  you  as  a  user.)  The  right  to  list, 
read,  and  execute  the  file  of  another  user  varies  by  default  among  machines  where 
NLS  runs;  a  user  may  reset  privacy  for  his  directory  or  for  one  file.  In  addition 
to  these  three  functions,  you  may  write  on  your  own  files  and  possibly  those  of  a 
group  of  co-workers.  With  the  Set  TENEX  (protection)  command,  you  may 
extend  or  restrict  any  of  these  four  functions,  to  yourself,  your  group,  or  all  users, 
for  your  files.  Note:  The  Set  TENEX  (protection)  command  in  NLS  does  not 
work  at  the  present  time.  With  the  Set  NLS  (protection  for  file)  command,  you 
can  restrict,  to  any  list  of  idents,  read  (and  therefore  write)  access  to  your  files. 
There  is  also  a  Private  command  in  the  SENDMAIL  subsystem. 

Set  TENEX  (protection  ...  )  command:  See  set  TENEX. 

Set  NLS  (protection  ...  )  command:  See  set  NLS. 

SENDMAIL  Private  command:  See  private  (SENDMAIL). 

Showing  lists  of  files:  See  Show  Directory. 

write  access  to  files:  See  write. 

executing  program  files:  See  running  (PROGRAMS). 

Private  OK:  The  Sendmail  subsystem  command  "Private"  marks  the  Sendmail 
Item  to  allow  only  those  mentioned  in  the  sendlist  to  read  the  item.  It 

automatically  places  the  AccessList  IDENTLIST  into  the  header  of  the 
Journalized  Document.  Only  those  in  the  AccessList  IDENTLIST  can  Forward 
the  document  to  others  not  in  the  original  sendlist.  See  also:  Send;,  sendlist, 
Forward,  Sendmail  public,  Base  Private. 

problems  with  using  parens  ():  Since  parentheses  are  legal  characters  in  a 
filename,  placing  two  links  delimited  by  parens  next  to  each  other  not  separated 
by  a  space  causes  an  irresolvable  confusion.  Also,  it  is  possible  for  parenthetical 
clauses  in  a  statement  to  become  confused  with  links.  If  you  are  using  the  Link 
entity  while  editing  a  link  that  does  not  have  proper  syntax,  it  is  possible  to  end 
up  editing  the  parenthetical  clause  instead.  To  avoid  confusion,  we  suggest  you 
use  angle-brackets  <  >  instead  of  parentheses  in  links. 

.PROC-REP;  An  L10  Procedure  Replacement  program:  A  filename  with 

this  extension  points  to  a  compiled  L10  procedure  whose  name  is  the  same  as  the 
L10  procedure  currently  in  effect.  The  Load  Program  command  will  place  the 
new  procedure  in  your  buffer  and  replace  the  old  one.  See  <NLS,  sysgd,  >  for  the 
list  of  procedures.  See  also:  Procedure. 

Procedures  (routines)  you  can  use  to  write  programs:  Procedures  are 
sub-routines  which  can  be  "called"  by  any  program  to  do  its  thing.  See  also: 
Compile  Procedure. 
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Process:  NLS  provides  commands  that  execute  a  series  of  other  commands.  You 
can  also  have  any  series  of  commands  executed  automatically  by  using  the  Startup 
Command. 

Process  (sendmail  form  at)  DESTINATION  OK:  The  Sendmail  subsystem  command 
’Process"  causes  a  previously  entered  and  properly  filled  Sendmail  form  or  Sendmail  Status 
form  to  be  processed  by  one  command  saving  the  user  from  specifying  each  command 
separately.  Be  sure  you  specify  the  type  of  source  before  using  this  command.  See  also: 
process  (PROGRAMS). 

types  of  sources:  5eeitem  (SENDMAIL). 

Insert  Sendmail  form  command  in  the  BASE  subsystem:  See  Insert  Sendmailform. 

Insert  Status  form  command  in  the  SENDMAIL  SUBSYSTEM:  See  Insert  Status 
(SENDMAIL). 

The  formats  for  sendmail  commands:  See  sendmailforms. 

Process  (commands  from)  STRUCTURE  OK:  The  command  "Process"  carries  out  a  list  of 
commands  written  for  DEMAND  recognition  mode.  Insert  CTRL  characters  (like  CA, 
OKREPEAT,  etc.)  by  using  the  literal  escape  key  <  CTRL- V  >  before  typing  the  CTRL 
character.  Note  that  DEMAND  recognition  mode  requires  a  space  after  each  Commandword 
even  if  it  is  followed  by  CA.  You  can  have  the  system  automatically  process  commands 
everytime  you  login  by  using  the  Useroptions  Startup  command.  The  system  will  automatically 
load  the  programs  and  subsystems  you  specify  in  the  USEROPTIONS’  Include  and  Entry 
commands.  See  also:  STRUCTURE. 

The  Useroptions  Startup  command:  See  Startup. 

Profile  defining:  the  Useroptions  subsystem:  See  Useroptions. 

program:  content-analyzer  program:  When  you  specify  a  content-analyzer  pattern, 
NLS  constructs  an  L10  program  that  looks  for  the  pattern  in  each  statement  and 
only  displays  the  statement  if  the  pattern  matches.  You  can  gain  more  control 
and  do  more  things  if  you  build  the  L10  program  yourself.  The  program  will  be 
used  just  like  the  simple  pattern  program  and  has  many  of  the  same  limitations. 
Programs  are  written  in  NLS  just  as  you  write  any  other  information.  They  then 
can  be  converted  to  executable  code  by  a  compiler.  This  code  resides  (or  is 
loaded)  in  your  programs  buffer  space  where  it  can  be  instituted  as  the  current 
content-analyzer  like  a  content-analyzer  pattern.  COMPARE  content-analyzer 
pattern.  See:  programs. 

library  of  "approved"  compiled  content-analyzer  programs:  See  content-analyzers. 
Programming  for  users:  See  program. 

Programs  subsystem:  user  programming  software:  In  addition  to  the  stock 
capabilities  of  NLS  you  may  write  your  own  special  functions  or  load  a  program 
or  subsystem  already  written  and  compiled.  These  programs  may  serve  as 
complex  filters  through  which  you  may  view  a  file,  or  they  may  actually  modify 
the  file.  Simple  Content  patterns  may  be  set  from  the  BASE  subsystem.  See  also: 
Set  Content. 

commands  in  the  Programs  subsystem:  Control  over  user  programs  is  through  the 
Programs  subsystem.  Programs  may  be  compiled,  loaded  into  the  user  programs  buffer,  and 
used.  A  complete  explanation  of  the  commands  accompanies  instructions  on  using  L10  to 
write  filters  and  programs  in  the  L10  Users’  Guide. 
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Attach  Subsystem  SUBSYSTEM  OK:  See  Attach  (PROGRAMS). 

Compile:  See  Compile  (PROGRAMS). 

Deinstitute  PROGTYPE  (program)  OK:  See  Deinstitute  (PROGRAMS). 

Delete:  See  Delete  (PROGRAMS). 

Execute  (command  in)  SUBSYSTEM:  See  Execute. 

Goto  SUBSYSTEM  OK:  See  Goto. 

Institute  PROGTYPE  (program)  CONTENT  OK:  See  Institute  (PROGRAMS). 

Jump:  See  Jump. 

Kill  TENEX  (subsystem)  OK:  See  Kill  (PROGRAMS). 

Load  Program  CONTENT  OK:  See  Load  (PROGRAMS). 

OKREPEAT  <CTRL-B>:  See  OKREPEAT. 

Quit:  See  Quit. 

Reset:  See  Reset  (PROGRAMS). 

Run  Program/TENEX  ...  :  See  Run  (PROGRAMS). 

Set:  See  Set  (PROGRAMS). 

Show  Status/TENEX  ...  :  See  Show  (PROGRAMS). 

semicolon:  See  Semicolon. 

writing  programs:  See  writing, 
compiling  user  programs:  See  compiling, 
loading  user  program  files:  See  loading, 
running  programs:  See  running. 

commands  in  the  Programs  subsystem:  See  commands, 
userprograms  library:  See  userprograms. 

Prompt  PMODE  OK:  PMODE 

The  Useroptions  subsystem  command  "Prompt"  allows  you  to  turn  prompts  off, 
to  show  the  basic  alternatives  in  commands,  or  to  show  all  options  as  well  as 
alternatives.  If  you  have  previously  used  this  command  to  change  your 
prompting,  you  may  return  to  partial  prompting  with  this  command  or  with  the 
Reset  Prompt  command.  To  see  what  kind  of  prompting  is  currently  set,  use 
Useroption's  Show  Prompt  command. 

PMODE:  Off.  Partial,  Full:  These  are  the  modes  you  can  choose  for  prompting.  Off  will 
suppress  prompting  completely.  Partial  is  the  default  and  prompts  you  for  all  nonoptional 
alternatives.  Full  will  prompt  you  for  all  your  choices,  including  options.  See  also:  optional, 
alternatives. 

See  also:  prompts,  optional,  alternatives,  Useroptions  Reset  Prompt,  Useroptions  Show 
Prompt. 

prompts:  symbols  printed  by  the  system  indicating  the  command  input  it  expects 
from  you.  When  partial  prompting  or  full  prompting  is  set  on  by  the  Useroptions 
subsystem,  single  characters  or  brief  strings  followed  by  colons  will  appear  in  the 
course  of  NLS  commands  to  show  what  type  of  input  will  work  next,  (like  a 
commandword  or  text).  "Partial  prompting"  lists  simple  choices;  "Full 
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prompting"  indicates  all  the  alternatives  and  options  you  have  at  each  point. 
Compare  Heralds,  See  also:  Prompt  (USEROPTIONS) . 

T/-:  is  a  prompt  for  the  Help  command:  See  help. 

C:  is  a  prompt  for  Commandword:  See  commandword . 

A:  is  a  prompt  for  ADDRESS  and,  in  TNLS,  for  DESTINATION:  See  ADDRESS. 

T/  [  A  ] :  is  a  prompt  for  CONTENT  in  TNLS:  See  content. 

A/  [  T  ] :  is  a  prompt  for  SOURCE  in  TNLS:  See  source. 

B/A:  is  a  prompt  for  DESTINATION  in  DNLS:  See  destination. 

B/T/  [  A  ] :  is  a  prompt  for  CONTENT  in  DNLS:  See  content. 

B/ A/  [  T  ] :  is  a  prompt  for  SOURCE  in  DNLS:  See  source. 

/  means  alternative:  See  alternatives. 

V:  is  a  prompt  for  VIEWSPECS:  See  viewspecs. 

L:  is  a  prompt  for  LEVEL-ADJUST  (d/u):  See  level -adjust. 

SP:  is  a  prompt  for  SPACE:  In  a  few  commands  NLS  requires  a  space  to  continue  and  prompts 
SP:  .  Strike  the  space  bar. 

CA:  is  a  prompt  for  Command  Accept  <CTRL-D>  :  When  prompting  is  on,  in  some  commands 
NLS  asks  for  CA  (command  accept)  to  mark  the  end  of  the  step.  CA  is  <CTRL-D>  and  is 
carriage  return  on  most  TNLS  terminals.  See  also:  prompts,  CA. 

Y/N:  is  a  prompt  for:  ANSWER  y  =  yes;  n  =  no:  See  answer. 

RPT:  is  a  prompt  for:  OKREPEAT  <CTRL-B>:  Seerpt. 

OK:  prompts  CA  or  RPT  or  OKINSERT:  When  prompting  is  on  and  you  have  finished  giving  a 
command,  NLS  prompts  you  with  "OK:  ".  It  expects  you  to  confirm  that  you  want  the 
command  to  take  place  as  written.  CA,  OKREPEAT,  or  OKINSERT  will  serve  as 
confirmation.  OKREPEAT  and  OKINSERT  effect  the  next  command.  Command  delete 
(CD)  is  an  alternative  at  any  point  in  a  command  before  the  final  confirmation. 

>  ...  means  "doing  it":  While  this  is  displayed  (in  DNLS  only),  the  computer  is  running  and 
doing  the  task  you  have  just  specified.  When  it  gets  done,  a  prompt  for  your  next  input  will 
appar. 

OPT:  and  [  ]:  are  prompts  for  OPTION  character  <CTRL-U>:  See  optional. 

Stars:  **  prompt  for  Special  alternatives  and  FILTER  See  Stars. 

Protect:  See  privacy. 

PROTECTION:  You  can  set  your  TENEX  protection  with  three  pairs  of  numbers. 
The  first  two  numbers  are  for  you.  The  second  two  numbers  are  for  people  in 
your  directory  group.  The  last  two  numbers  are  for  the  outside  world.  The  pair 
77  means  reading,  writing,  and  for  programs,  execution  is  allowed.  52  means  read 
and  execute,  but  not  write.  00  means  don’t  allow  access  and  in  fact,  don’t  even 
let  anyone  not  connected  to  your  directory  see  the  file  exists.  You  can  change 
your  TENEX  protection  status  with  the  NLS  Set  TENEX  Protection  command 
or  the  Rename  File  Command  in  TENEX.  See  PRIVACY. 

example:  775200 

775200  means  you  can  read,  write,  and  execute  this  file.  People  in  your  directory  group  can 
read,  execute  and  not  write  your  file.  And  the  outside  world  can’t  even  see  your  file 
exists. 
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Protocol:  The  rules  of  interaction  between  two  processes.  In  computer  work,  the 
rules  of  interaction  between  two  programs.  Among  users  of  the  ARPA  Computer 
Network,  there  is  a  document  describing  conventions  for  talking  between 
computers  over  the  Network  called  the  "Protocol  Notebook".  This  is  available 
from  the  Network  Information  Center. 

Public:  The  Sendmail  subsystem  command  "Public"  makes  a  Sendmail  item 

marked  Private  in  that  session  return  to  being  Public. 

publish:  See  hardcopy. 

Publish:  Use  the  user-subsystem  "Publish"  to  automatically  generate  a  Table  of 
Contents,  References  in  standard  formats  from  Links  to  Journal  items  or  an  Index 
keyed  to  statement  numbers.  You  can  also  count  "words".  These  are  the 
commands  available: 

Count  (visibles  in)  STRUCTURE  (at)  DESTINATION  OK:  The  command  "Count"  in  the 
PUBLISH  user-subsystem  counts  the  number  of  visibles  in  the  STRUCTURE  at  the 
DESTINATION  you  specify. 

Filtered  alternative:  Instead  of  typing  the  "OK",  you  can  type  an  "F"  to  have  the  count 
operate  through  the  FILTER  viewspecs  you  specify. 

Count  (visibles  in)  STRUCTURE  (at)  DESTINATION  Filtered:  VIEWSPECS  OK 

See  filter. 


GENERATE  TABLE/REFERENCES  ... 

Table:  Generate  Table  (of  Contents  for  File  at)  DESTINATION:  (number  of  levels  of 
depth)  CONTENT  OK: 

The  command  "Generate  Table"  in  the  PUBLISH  user-subsystem  asks  you  to  specify  a 
File  and  the  number  of  levels  of  depth  you  wish  included  in  the  table.  The  new  Table  of 
Contents  branch  is  added  as  the  first  level-one  branch.  The  Table  of  Contents  does  not 
cite  pages,  it  cites  statement  numbers  so  the  body  of  the  formatted  version  should  have 
statement  numbers  printed  to  make  the  Table  useful.  You  will  not  want  to  print  the 
statement  numbers  for  the  Table  of  Contents. 

References:  Generate  References  (from  Journal  links  in  file  at)  DESTINATION  (using 
format  number)  CONTENT  OK: 

The  command  "Generate  References"  in  the  PUBLISH  user-subsystem  asks  you  to 
specify  a  file  for  DESTINATION  and  the  number  for  the  format  you  wish  to  use  for 
CONTENT.  The  file  you  specify  is  searched  for  links  to  journal  items.  When  one  is 
found,  catalog  indexes  are  searched  for  the  reference  information.  Available  formats  of 
references  are: 

0  (Refl2345)  Author,  "Title",  DATE.  [Cited  in  1A2B:  (JOURNAL,  12345,  )] 

1  (12345,  )  Author.  Title.  Augmentation  Research  Center,  Stanford  Research 
Institute.  Menlo  Park,  California  94025.  DATE. 

2  (1A2B)  Author.  Title.  Augmentation  Research  Center,  Stanford  Research 
Institute,  Menlo  Park,  California  94025.  DATE  (JOURNAL,  12345,  ) 

Index  STRUCTURE  (at)  DESTINATION  OK:  The  command  "Index"  in  the  PUBLISH 
user-subsystem  invokes  an  experimental  program  that  creates  a  word  index  for  a  statement, 
branch,  group,  or  plex.  It  inserts  the  Index  as  a  branch  at  the  same  level  at  the  end  of  a  group 
or  plex,  down  from  a  statement,  or  at  the  end  of  the  plex  down  from  a  branch.  It  filters  with 
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respect  to  viewspecs.  This  program  is  slow,  and  creates  a  large  index.  It  will  only  work  on 
very  small  chunks  of  files  (100  statements  or  so).  The  index  may  have  to  be  hand  edited  after 
creation  to  shorten  it.  It  excludes  all  words  ending  with  "ly",  all  numbers,  all  words  less  than 
or  equal  to  two  characters,  and  all  words  in  a  list  in  the  file  <  programs,  publish,  a  > .  Send 
candidates  for  the  exclusion  list  to  FEEDBACK.  See  also:  filter,  structure. 
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q  ViewSpeC:  show  one  line  less:  "Show  one  less  line  than  appeared  before."  This 
viewspec  will  change  or  modify  viewspecs  w  and  s  (counting  back  from  the 
highest  number  of  lines),  x  and  t  (you  won’t  see  anything),  and  r  (each  q  cancels 
out  one  r). 

Q4:  Queue  four:  the  postion  in  the  time  sharing  waiting  line  in  which  a  job  has 
had  its  processing  suspended.  TENEX  puts  your  job  on  one  of  four  queues  (lines) 
waiting  to  be  done.  Some  queues  have  a  higher  priority  than  others.  If  you  use 
up  too  much  clock  time  while  your  process  is  being  executed  and  the  load  average 
is  high,  you  get  placed  in  Queue  four  (Q4)  which  gets  no  service  until  the  load 
average  drops. 

query:  NIC  offers  a  system  to  search  for  and  recategorize  information  on  certain 
subjects.  A  few  commands  enable  you  to  sift  large  files  on  named  subjects.  The 
Network  Resource  Notebook  is  now  available  through  query. 

Questionmark:  (?):  Typing  a  question  mark  at  any  point  in  an  NLS  command, 
will  show  you  the  NLS  command  alternatives  available  at  that  point.  After  the 
list  has  printed  you  can  go  on  as  if  you  had  not  typed  questionmark.  Type 
<CTRL-0>  to  stop  printing.  See  also:  CTRL-Q. 

Quit  OK:  The  command  "Quit"  allows  you  to  leave  the  subsystem  you  are 
working  in  and  return  to  one  you  were  last  working  in.  The  "Quit  OK" 
command  takes  you  to  the  subsystems  you  were  just  in.  If  you  want  to  quit  back 
to  an  even  earlier  subsystem,  use  the  Quit  To  SUBSYSTEM  command.  The 
subsystem  you  Quit  from  is  erased  from  your  subsystem  stack.  See  stack. 

TNLS  example: 

SEND  C:  Quit  OK:/C: 

BASE  C: 

To:  Quit  To  SUBSYSTEM  OK:  The  command  "Quit  to"  returns  you  to  any  subsystem  you 
have  in  your  subsystem  stack. 

TNLS  example: 

PROG  C:  Quit  OK:/C:  To  C:  Base  OK: 

BASE  C: 

Effects:  You  will  be  returned  TO  the  subsystem  you  name  after  "To".  A  subsystem  stack 
lists  the  subsystems  you’ve  been  in  (See:  Stack).  If  you  don’t  supply  a  name,  you  will 
return  to  the  most  recent  subsystem  in  the  stack.  The  subsystem  you  are  quitting  from, 
as  well  as  all  of  those  between  it  and  the  one  you  quit  TO,  will  be  erased  from  your 
subsystem  stack.  See  also:  Quit. 

SUBSYSTEM:  See  subsystem. 
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NLS:  Quit  NLS  OK:  The  command  "Quit  NLS"  allows  you  to  leave  NLS  (all  the  subsystems) 
and  return  to  the  TENEX  Executive.  It  is  slightly  slower  than  typing  <CTRL-C>  but  much 
safer  and  we  recommend  you  use  this  command  instead  of  <CTRL-C> .  See  also:  <CTRL-C>. 

TNLS  example. 

BASE  C:  Quit  OK:/C:  NIs  OK: 

atsign  is  the  TENEX  herald. 

Effects:  Atsign  (@)  is  the  TENEX  herald.  You  can  reenter  NLS  with  the  TENEX 
command  CONTINUE. 

See  also:  TENEX,  herald. 

See  also:  SUBSYSTEMS,  herald,  Goto,  Execute. 
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r  ViewspeC:  show  one  line  more:  "Show  one  more  line  than  was  previously 
specified."  This  viewspec  is  often  combined  with  x  or  t;  each  r  in  the  string  adds 
one  more  line  of  each  statement.  If  combined  with  q,  each  r  cancels  out  one  q. 

RADC:  Acronym  for  Rome  Air  Development  Center.  A  group  at  Rome  began 
using  NLS  in  1971. 

Random:  See  Sequential. 

re  — creating  the  display:  After  you  move  to  another  location  in  a  file,  change  the 
type  of  view  or  change  something  in  the  part  of  the  file(s)  you  have  in  view, 
DNLS  has  to  re-format  the  file-display  area  to  show  the  changes  in  their  proper 
context.  If  you  have  viewspec  u  on,  this  happens  automatically  upon  execution  of 
every  command.  Viewspec  v  suppresses  that  automatic  re-creation,  which  saves 
time  during  some  repetitious  operations  (Warning:  you  may  point  to  a  statement 
no  longer  there  while  viewspec  v  is  on).  Independently  of  either  viewspec, 
re-creation  will  take  place  immediately  upon  specifying  viewspec  f.  See  also:  F. 

Note- -Inputting  Viewspecs  with  mouse  buttons  is  not  a  command:  so  viewspec  u  will 
not  affect  this;  so  put  in  an  f  at  the  end  of  the  series  of  lower-case  viewspecs.  See  also: 
buttons. 

reaching  subsystems:  NLS  has  subsystems  for  specific  tasks,  such  as  editing 
files  and  sending  mail.  You  are  automatically  put  into  the  BASE  subsystem  when 
you  enter  NLS.  You  can  also  enter  subsystems  with  the  Goto  command.  If  you 
want  to  give  only  one  command  in  a  subsystem  you  are  not  presently  in,  use  the 
command  "Execute"  and  then  give  the  name  of  the  subsystem  you  want  to  use. 

Goto  command:  5eeGoto. 

Execute  command:  See  Execute. 

Reading  and  viewing  information:  You  can  read  any  NLS  files  whose  name 
you  know',  except  files  whose  access  has  been  specifically  restricted.  You  call  files 
with  the  Load  File  command.  After  you  have  loaded  it,  you  can  move  around 
within  its  structure  by  "pointing"  to  the  specific  place  you  want  to  go.  You  can 
view  a  file  in  different  ways  with  viewspecs  or  you  can  print  it  out  for  reading. 
See  also:  pointing,  information.  For  DNLS,  See  also:  viewing. 

accessing  files:  See  accessing. 

moving  around  in  files  and  printing  on  your  terminal  in  TNLS:  The  family  of  Jump  and 
Print  commands  are  used  to  view  information  in  TNLS.  Jump  to  Address  is  the  basic  TNLS 
pointing  command.  Other  Jump  commands  point  to  a  character  within  a  statement;  some  point 
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to  files;  and  some  point  to  statements  by  their  structural  position.  See  also:  pointing,  file, 
structural,  Jump  Address,  printing  (TNLS). 

Hardcopy  printing  and  formatting:  See  hardcopy. 

Windowing  and  DNLS  viewing:  See  viewing. 

Sendmail  reading:  See  Print  Journal. 

privacy  provisions:  See  privacy. 

commands  for  viewing:  See  viewing-commands. 

Reading  your  mail:  In  TNLS,  use  the  Print  Journal  command.  Mail  you  receive 
appears  in  your  initial  file  in  the  form  of  citations.  New  citations  are  added  at 
the  top  for  quicker  viewing  of  the  most  recent  ones.  The  message  "You  Have 
New  Journal  Mail"  appears  when  you  login  if  mail  has  been  delivered  to  you 
since  you  last  logged  in.  It  is  a  recommended  practice  to  create  a  branch  in  your 
initial  file  named,  for  example,  "done"  to  which  journal  items  can  be  moved  as 
they  have  been  read.  Then  the  Print  Journal  command  will  only  get  new  items. 
See  also:  reading. 

In  DNLS:  Secviewing.  See  also:  initial,  TNLS,  DNLS,  sndmsg. 

Journal:  stored  items  See  Journal. 

Numbering  system:  See  Numbering. 

recognition: 

Command  recognition:  In  specifying  a  command,  you  must  type  certain  characters.  The 
system  can  recognize  commandwords  after  a  certain  number  of  letters.  There  are  four  modes 
by  which  NLS  will  recognize  commandwords:  Terse,  Fixed,  Anticipatory,  and  Demand.  Use 
the  Useroptions  subsystem  Recognition  and  Show  Recognition  commands  to  change  and  see 
your  recognition  mode.  See  also:  show  (USEROPTIONS),  recognition  (USEROPTIONS). 

Fixed  Mode:  See  Fixed. 

Anticipatory  Mode:  See  Anticipatory. 

Demand  Mode:  See  Demand. 

Terse  Mode:  See  Terse. 

FILENAME  recognition  and  defaults:  In  specifying  a  file,  you  must  give  NLS  certain 
information  and  then  it  will  be  able  to  recognize  the  file  that  you  want. 

star  convention:  &?estar. 

<ESC>:  Escape  and  <CTRL-F>  See  ESC. 

defaults:  See  defaults. 

recognition-TENEX:  (recognition  of  commands  in  TENEX):  Commands  in  TENEX,  either  the 
Executive  or  a  subsystem  of  NLS,  are  recognized  in  the  Demand  mode.  See  demand. 

Note:  If  you  use  <SP>  rather  than  <ALT>  to  force  recognition,  the  rest  of  the 
commandword  and  following  noisewords  won’t  echo. 

Additional  shortcut  for  TENEX  commands  only:  When  a  TENEX  commandword  is 
at  the  end  of  the  command,  or  all  there  is  in  the  command,  you  may  just  type  enough 
letters  for  uniqueness  and  then  a  <CR>.  You  won’t  get  any  feedback. 

TENEX  has  commandwords  and  noisewords  similar  to  NLS.  See  notation. 
Recognition  (mode)  RMODE  OK:  The  Useroptions  subsystem  command  "Recognition"  allows 
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you  to  change  your  recognition  mode.  Your  choices  for  RMODE  are--Fixed,  Anticipatory, 
Demand,  and  Terse.  With  Terse,  choose  one  of  the  above  for  the  secondary  recognition  mode. 
See  also:  Reset  Recognition  (USEROPTIONS),  Show  Recognition  (USEROPTIONS). 

RMODE:  Recognition  and  the  Recognition  Modes:  See  recognition. 

RMODE  =  Anticipatory 
or  Demand 
or  Fixed 

or  Terse  (secondary  mode)  RMODE2 
RMODE2  =  Anticipatory  or  Demand  or  Fixed  or  Terse. 

recording,  marking  characters. 

Playback  Record  (of  session  from  file)  CONTENT  ...  See  Playback. 

Start  Record  (of  session  to  file)  CONTENT  OK:  See  Start. 

Stop  Record  (of  session)  OK:  See  Stop. 

Mark  Character  (at)  DESTINATION  (with  marker  named)  CONTENT  OK:  See  Mark. 

.  REL;  RELocatable  L10  program  (file):  A  filename  with  this  extension  points 
to  a  compiled  L10  program  that  can  be  placed  in  your  programs  buffer  with  the 
Load  Program  command  in  the  Programs  subsystem.  See  also:  loading. 

Release:  The  DNLS  command  "Release"  thaws  statements  that  were  frozen  with 
the  "Freeze"  command.  See  also:  Freeze. 

All:  Release  All  (frozen  statements)  OK:  The  DNLS  command  "Release  All"  thaws  all 

statements  that  were  frozen  with  the  "Freeze"  command.  See  also:  Freeze. 

Frozen:  Release  Frozen  (statement  at)  DESTINATION  OK:  The  DNLS  command  "Release 
Frozen"  thaws  the  statement  you  specify  for  DESTINATION  that  was  frozen  with  the 
"Freeze"  command.  See  also:  Freeze. 

remote:  printing  at  a  TIP:  See  Output  Remote. 

Renumber  Sids  (in  file)  OK:  The  command  "Renumber  Sids"  renumbers  all 
the  SIDs  in  the  file  you’re  in  to  be  sequential,  ignoring  the  outline  structure. 
SIDs  were  originally  assigned  to  statements  in  order  of  creation.  See  also:  SIDs, 
structure. 

TNLS  example: 

BASE  C:  Renumber  C:  SIDs  in  file  OK: 

BASE  C: 

Effects-no  side  effects,  we  hope. 

repeat:  5^  OKREPEAT. 

Replace  STRING/STRUCTURE  (at)  DESTINATION  (by  accumulator) 
OK:  Use  the  Calculator  subsystem  command  "Replace"  to  replace  a  STRING 
or  STRUCTURE  (such  as  a  visible  or  a  branch)  with  the  value  of  the 
accumulator.  See  also:  DESTINATION,  STRUCTURE,  STRING,  accumulator. 

Replace:  The  Base  command  "Replace"  allows  you  to  erase  one  of  the  following 
things  at  the  DESTINATION  you  specify  and  put  in  some  other  CONTENT  you 
specify.  It  combines  the  Insert  and  Delete  commands  into  one  command. 

STRING:  Replace  STRING  (at)  DESTINATION  (by)  CONTENT  OK:  This  group  of 
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"Replace"  commands  erases  an  existing  STRING  and  replaces  it  with  another  of  the  same 
kind  that  you  copy  or  characters  that  you  TYPEIN. 

TNLS  example: 

BASE  C:  Replace  C:  Character  (at)  A:  7a  +e 

by  T:  . 

BASE  C: 

Effects:  CONTENT  provides  you  the  choice  of  pointing  (as  an  option)  to  a  STRING  to  be 
copied  as  a  replacement,  or  of  typing  one  in  from  the  keyboard.  After  execution  you  are 
at  the  last  character  of  the  new  STRING.  When  replacing  a  link,  angle-bracket 
delimiters  will  be  automatically  supplied  if  you  supply  no  delimiters. 

Warning  when  replacing  links:  See  warning. 

STRING:  Character,  Text,  Word,  Visible,  Invisible,  Number,  or  Link:  See  string. 

STRUCTURE:  Replace  STRUCTURE  (at)  DESTINATION  (by)  CONTENT  OK.  This  group  of 
commands  erases  an  existing  STRUCTURE  and  replaces  it  with  another  of  the  same  kind  that 
you  copy,  or  with  a  something  that  you  type  in. 

TNLS  example: 

To  replace  a  plex  with  a  single  statement: 

BASE  C:  Replace  C:  Plex  (at)  A:  2a 

by  T:  It  was  all  lies. 

BASE  C: 

Effects:  CONTENT  provides  you  the  choice  of  pointing  (as  an  option)  to  a  STRUCTURE 
to  be  copied  as  a  replacement,  or  of  typing  a  statement  in  from  the  keyboard.  After 
execution  you  are  at  the  first  character  of  the  new  STRUCTURE. 

STRUCTURE:  Statement,  Branch,  Plex,  or  Group:  See  structure. 

reporting  bugs  and  making  suggestions:  In  systems  and  their 

documentation,  a  bug  is  anything  that  does  not  work  as  documented.  Report 
bugs,  questions,  your  difficulties  with  the  system,  and  suggestions  about 
improvements  on  the  system  to  the  Feedback  mechanism  located  at  OFFICE- 1: 
send  a  message  to  Ident  FEEDBACK  with  Sendmail,  or  to  username 
FEEDBACK  with  Sndmsg.  In  the  same  way,  you  may  also  ask  FEEDBACK 
about  OFFICE- 1  or  NLS  status,  current  plans,  and  the  decision  status  of  others’ 
suggestions.  See  also:  SNDMSG,  IDENT,  SENDMAIL. 

All  messages  will  normally  be  answered  within  one  working  day,  You  should  receive  some  response 
to  your  messages  whether  they  are  immediate  problems  (such  as  a  bad  file),  a  bug  report,  a 
design  bug,  or  a  design  recommendation.  If  a  problem  cannot  be  fixed  immediately,  an 
acknowledgement  will  be  sent  indicating  a  specialist  will  handle  it  as  soon  as  software/hardware 
resources  are  available,  and  any  further  developments  reported  to  the  feedback  originator.  All 
other  inquiries  (like  suggestions)  that  need  to  be  studied  will  also  be  promptly  acknowledged. 

Reserve:  The  Sendmail  subsystem  command  "Reserve"  allows  you  to  reserve  one 
of  the  following  types  of  numbers.  See  also:  numbering. 

Journal:  Reserve  Journal  (numbers  --  how  many?)  CONTENT:  (insert  the  number  list?) 
RESPOND 

RESPOND  =  Yes  (to  follow)  DESTINATION  OK: 
lor!  No  OK: 

The  Sendmail  subsystem  command  "Reserve  Journal"  allows  you  to  reserve  up  to  20  Journal 
numbers  by  specifying  a  count  for  the  CONTENT.  They  will  print  out  at  your  terminal.  You 
can  have  the  list  inserted  at  the  DESTINATION  you  specify  if  you  type  "y"  for  Yes  to 
RESPOND.  See  also:  numbering. 
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Journal  number:  See  number  (SENDMAIL). 

XdoC:  Reserve  Xdoc  (numbers  —  how  many?)  CONTENT:  (insert  the  number  list?)  RESPOND 
RESPOND  =  Yes  (to  follow)  DESTINATION  OK: 
lor!  No  OK: 

The  Sendmail  subsystem  command  "Reserve  Xdoc"  allows  you  to  reserve  up  to  20  XDOC 
numbers  for  items  that  you  do  not  intend  to  access  online  by  specifying  a  count  for  the 
CONTENT.  They  will  print  out  at  your  terminal.  You  can  have  the  list  inserted  at  the 
DESTINATION  you  specify  if  you  type  "y"  for  Yes  to  RESPOND.  See  also:  XDOC, 
numbering. 

Journal  number:  See  number  (SENDMAIL). 

RFC:  Reserve  RFC  (number)  OK:  (title)  CONTENT 

(author)  CONTENT 

(send  to)  CONTENT 

(online  document?)  ANSWER 

(show  status?)  ANSWER 

(insert  the  number  list?)  ANSWER 

(to  follow)  DESTINATION  OK: 

The  Sendmail  subsystem  command  "Reserve  RFC"  allows  you  to  reserve  one  RFC  number  by 
answering  the  questions.  You  can  have  the  number  inserted  at  the  DESTINATION  you 
specify  if  you  say  Yes  to  RESPOND.  See  also:  RFC,  numbering. 

Journal  number:  See  number  (SENDMAIL). 


Reset: 

All:  Reset  All  OK:  The  Useroptions  subsystem  command  "Reset  All"  returns  all  Useroptions 
parameters  to  the  new  user’s  system  defaults.  In  effect,  it  executes  every  Useroptions  Reset 
command.  Reviewing  each  item  below  will  take  you  to  a  fuller  description  of  the  individual 
Reset  commands  that  will  be  executed: 

Control  character  definitions  for  All  terminals  back  to  defaults.  Carries  out:  Reset  Control 
(characters  for  terminal)  All  OK.  See  Reset  control  (USEROPTIONS). 

Commandwords  will  be  recognized  upon  typing  enough  letters  to  identify  them  uniquely 
(Terse  Mode).  Carries  out:  Reset  Recognition  (mode)  OK.  See  Reset  Recognition 
(USEROPTIONS). 

Feedback  of  noisewords  and  commandwords  becomes  full.  Carries  out  both:  Reset  Feedback 
Mode  OK  and  Reset  Feedback  Length  OK.  See  Reset  Feedback  (USEROPTIONS). 

You’ll  be  prompted  for  all  non-optional  alternatives  in  commands  (Partial  prompting). 
Carries  out:  Reset  Prompt  (mode)  OK.  See  Reset  Prompt  (USEROPTIONS). 

Resets  size  of  return  ring  to  be  10.  Carries  out:  Reset  Return  (ring  entries)  OK.  See  Reset 
Return  (USEROPTIONS). 

Resets  size  of  file  return  ring  to  be  10.  Carries  out:  Reset  Filereturn  (ring  entries)  OK.  See 

Reset  Filereturn  (USEROPTIONS). 

Currentcontext  length-response  to  the  Slash-back  to  7  characters.  Carries  out:  Reset 
Currentcontext  (length)  OK.  See  Reset  Currentcontext  (USEROPTIONS). 

TNLS  heralds  will  be  the  first  4  characters  of  the  subsystem  name.  Carries  out  both:  Reset 
Herald  Mode  OK  and  Reset  Herald  Length  OK.  See  Reset  Herald  (USEROPTIONS). 

TNLS  page  specifications  (margins  and  size)  return  to  defaults.  Carries  out:  Reset 
Printoptions  Right  (margin)  OK  and  Reset  Printoptions  Left  (margin)  OK  and  Reset 
Printoptions  Bottom  (margin)  OK  and  Reset  Printoptions  Page  (size)  OK.  See  Reset 
Printoptions  (USEROPTIONS). 

All  TNLS  commands  will  start  printing  at  the  left  margin.  Carries  out:  Reset  Feedback 
Indenting  OK.  See  Reset  Feedback  (USEROPTIONS). 
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Tabstop  settings  return  to  default  columns.  Carries  out:  Reset  Printoptions  Tab  (stop 
settings)  OK.  See  Reset  Printoptions  (USEROPTIONS). 

The  Startup  commands  feature  to  be  disabled.  Carries  out:  Reset  Startup 
(commands  branch  address)  OK.  See  Reset  Startup  (USEROPTIONS). 

Control:  Reset  Control  (characters  for  terminal)  TERMINALS  OK:  The  Useroptions’  subsystem 
command  "Reset  Control"  sets  back  to  defaults  the  characters  that  stand  for  the  various 
control  functions.  You  must  specify  the  various  terminals  where  you  want  this  to  take  place. 

Effects:  If  you  choose  All  for  TERMINALS,  all  character  sets  will  return  to  default 
definitions.  Character  sets  can  be  seen  with  the  Useroptions  Show  Control  command. 
They  can  be  changed  with  the  Useroptions  Control  command. 

TERMINALS  =  Ti  (terminal)  or  Tasker  or  NVT 
or  Lineprocessor  or  Imlac  or  Execuport 
or  33-TTY  or  35-TTY  or  37-TTY  or  All. 

more  about  TERMINALS:  NVT  acronym  for  "Network  Virtual  Terminal". 

Specifying  Tasker,  Imlac,  or  Line  processor  will  set  up  definitions  only  for  the  use  of 
DNLS  from  that  terminal.  All  others  set  up  definitions  for  TNLS.  When  you  run 
TNLS  from  EXEC  on  one  of  those  display  terminals,  you’ll  get  the  character  set  for  Ti. 
Going  into  TNLS  via  Simulate  command  gets  you  the  set  for  the  terminal  you  specify. 

Control  functions:  CONTROLFUNCTIONS. 

See  also:  terminals,  Useroptions  Control,  Useroptions  Show  Control. 

Currentcontext:  Reset  Currentcontext  (length)  OK:  The  Useroptions’  subsystem  command 
"Reset  Currentcontext"  returns  the  number  of  characters  that  surround  the  character  you  are 
located  at  (as  shown  in  response  to  typing  a  slash)  to  the  default  value  of  7. 

To  change  the  number  of  characters  printed  to  other  than  7:  use  Useroption’s 
Currentcontext  command:  See  currentcontext  (USEROPTIONS). 

To  see  the  number  of  characters  presently  established:  use  Useroption’s  Show 
Currentcontext  command:  See  Show  Currentcontext  (USEROPTIONS). 

Default:  Reset  Default  (subsystems  and  programs)  OK:  The  Useroptions’  subsystem  command 
"Reset  Default"  sets  the  subsystems  and  userprograms  to  the  system  default.  There  are  no 
default  programs.  See  subsystems.  See  also:  Useroptions  Show  Default,  Useroptions  Entry, 
Useroptions,  Incude. 

Directive:  Reset  Directive  (filter)  OK:  The  Format  user-subsystem  command  "Reset  Directive" 
sets  your  current  content-analyzer  filter  to  what  it  was  before  the  Set  Directive  (filter) 
command.  This  only  works  for  one  window  in  DNLS  (be  careful  if  you  have  inserted  an  edge 
to  split  your  window). 

Feedback:  USEROPTIONS  Reset  Feedback  FEEDRESETS  OK:  The  Useroptions’  subsystem 
command  "Reset  Feedback"  allows  you  to  set  the  feedback  Mode  back  to  Verbose-noise 
words  will  appear.  For  your  TNLS  sessions,  you  may  set  the  Length  of  the  noisewords  you 
will  see  back  to  all  characters  (up  to  50).  You  can  also  set  the  completed  commandwords  you 
will  see  back  to  all  (up  to  50).  You  can  also  set  the  number  of  characters  for  indenting 
commands  back  to  zero. 

FEEDRESETS:  Mode,  Length,  Indenting. 

Mode:  Reset  Feedback  Mode  OK:  The  Useroptions  subsystem  command  "Reset  Feedback 
Mode"  sets  the  feedback  you  will  see  for  noisewords  back  to  verbose  which  is  the 
default. 

Length  and  Indenting  affect  TNLS  only-- 

Length:  Reset  Feedback  Length  OK:  The  Useroptions  subsystem  command  "Reset 

Feedback  Length"  sets  the  number  of  characters  you  will  see  for  noisewords  back  to  all 
(up  to  50). 
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Indenting:  Reset  Feedback  Indenting  OK:  The  Useroptions  subsystem  command  "Reset 
Feedback  Indenting"  returns  commands  to  the  left  margin  of  your  TNLS  printout. 

See  also:  command,  command  recognition,  commandword,  noiseword,  TNLS,  pointing, 
TYPEIN,  CONTENT,  Useroptions  Feedback,  Useroptions  Show  Feedback. 

Filereturn:  Reset  Filereturn  (ring  entries)  OK:  The  Useroptions’  subsystem  command  "Reset 
Filereturn"  returns  the  maximum  size  of  your  File  return  ring  to  10.  The  command  "Reset 
Return"  returns  the  statement  return  ring  size  to  10. 

Effects:  The  commands  won’t  take  effect  until  you  create  a  new  window  in  DNLS  or  until 
your  next  NLS  session.  They  will  remain  in  effect  for  subsequent  sessions  until  you 
change  the  size  again,  like  with  Useroptions’  Jump  command. 

See  also:  statement  return,  file-return,  Useroptions  Jump,  Useroptions  Show  Jump. 

Herald:  [affects  TNLS  only]  Reset  Herald  HERALDPARAMS  OK:  The  Useroptions’ 

subsystem  command  "Reset  Herald"  allows  you  to  set  the  herald  mode  from  Terse  back  to 
Verbose,  or  to  set  the  Length  of  a  Verbose  herald  back  to  being  the  first  four  characters  of  the 
subsystem  name.  See  also:  herald,  subsystem. 

HERALDPARAMS  =  Mode  or  Length:  Resetting  Mode  will  make  a  Terse  herald  (*) 
Verbose,  i.e.,  the  herald  will  be  the  First  few  characters  (current  Length)  of  the  current 
subsystem  name.  Resetting  Length  will  return  a  Verbose  herald  to  being  four  characters 
long. 

related  commands:  The  Useroptions  subsystem’  command  "Herald"  allows  you  to 
change  the  Length  and  the  mode  (Terse  or  Verbose)  of  heralds.  Use  the  Useroptions 
command  Show  Herald  to  see  the  status  of  your  heralds.  See  also:  Herald 
(USEROPTIONS),  Show  Herald  (USEROPTIONS). 

Return:  Reset  Return  (ring  entries)  OK:  The  Useroptions  subsystem'  command  "Reset  Return" 
returns  the  maximum  size  of  your  statement  return  ring  to  10.  See  also:  return  ring, 
file-return,  Useroptions  Return,  Useroptions  Show  Return. 

Effects:  The  commands  won’t  take  effect  until  you  create  a  new  window  in  DNLS  or  until 
your  next  NLS  session.  They  will  remain  in  effect  for  subsequent  sessions  until  you 
change  the  size  again,  like  with  Useroptions’  Jump  command. 

PrintoptionS:  Reset  Printoptions  PRINTSPECS  OK:  The  Useroptions’  subsystem  command 
"Reset  Printoptions"  allows  you  to  return  any  of  the  parameters  for  TNLS  Print  commands  to 
defaults.  These  defaults  are:  left  margin  at  column  0,  right  margin  at  column  72,  bottom 
margin  at  line  63,  page  size  of  66  lines.  Or  you  can  return  level  indenting  to  3  spaces  or 
tabstops  to  8,16,24,32,40,48,56,64,72,80,88,96,104.  For  the  meanings  and  effects  of  these 
specifications,  See  also:  command:  Useroptions  Printoptions. 

PRINTSPECS:  Right  (margin) 
or  Left  (margin) 
or  Bottom  (margin) 
or  Page  (size) 
or  Indenting  (per  level) 
or  Tab  (stop  settings) 

See  also:  the  related  status  command:  Useroptions  Show  Printoptions. 

Prompt:  Reset  Prompt  (mode)  OK:  The  Useroptions  subsystem’  command  "Reset  Prompt" 
returns  the  prompting  mode  to  Partial  which  is  the  default.  The  Show  Prompt  command  will 
indicate  your  current  prompting  mode.  The  Prompt  command  can  be  used  to  change  the  mode 
to  Off,  Partial,  or  Full. 

The  prompt  modes:  5eepmode. 

See  also,  prompts,  Useroptions  Show  Prompt,  Useroptions  Prompt. 
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Recognition:  Reset  Recognition  (mode)  OK:  The  Useroptions’  subsystem  command  "Reset 
Recognition"  returns  the  recognition  mode  to  the  beginner’s  default-Terse;  secondary  mode 
Terse.  You  can  control  recognition  mode  with  the  Useroptions’  Recognition  command.  Use 
the  Useroptions’  Show  Recognition  command  to  learn  your  current  recognition  mode. 

recognition  and  the  recognition  modes:  See  recognition. 

See  also:  these  related  commands: 

Useroptions  Recognition,  Useroptions  Show  Recognition. 

Startup:  Reset  Startup  (commands  branch  address)  OK:  The  Useroptions’  subsystem  command 
"Reset  Startup"  causes  the  startup  commands  branch  address  to  be  "none",  and  in  effect 
disables  it.  Invoke  the  mechanism  with  Useroptions’  Startup  command.  See  also:  STARTUP. 

Viewspecs:  Reset  Viewspecs  OK:  The  Useroptions’  subsystem  command  "Reset  Viewspecs"  will 
turn  OFF  the  Viewspecs  feature  of  NLS  in  this  and  following  NLS  sessions.  You  will  not  be 
able  to  specify  VIEWSPECS  in  Base’s  commands  and  the  hierarchical  structure  of  NLS  files 
will  be  invisible.  VIEWSPECS  for  all  levels,  all  lines,  hjmpuyBCEHJLP  will  be  initially  in 
effect  for  your  NEXT  and  subsequent  NLS  sessions.  To  see  definitions  of  individual 
VIEWSPECS,  See,  for  example,  J,  B,  x,  b,  or  p  Viewspec. 

See  also:  these  related  commands: 

Useroptions  Viewspecs,  Useroptions  Show  Viewspecs,  Base  Reset  Viewspecs,  Base  Set 
Viewspecs,  Base  Show  Viewspecs. 

Reset:  The  command  "Reset"  allows  you  to  change  back  to  the 

original-default-setting  any  one  of  the  following  things  that  you  specify.  See  also: 
SET,  RESET  (USEROPTIONS),  RESET  (PROGRAMS),  RESETTING. 

Archive:  Reset  Archive  (request  for  file)  CONTENT  OK:  The  command  "Reset  Archive" 
allows  you  to  reset  the  archival  status  of  all  files  to  the  original  mode  where  they  will  be 
archived  and  deleted  if  they  have  not  been  read  in  21  days.  CONTENT  wants  you  to  give  the 
name  of  a  file. 

Case:  Reset  Case  (mode)  OK:  The  command  "Reset  Case"  allows  you  to  reset  the  case  mode 
setting  for  subsequent  Set  Case  STRING  and  Set  Case  STRUCTURE  commands  to  "upper" 
(all  alphabetic  characters  will  be  capitalized).  This  is  the  default  setting.  This  case  mode 
setting  will  remain  in  effect  until  the  Set  Case  Mode  command  is  used  again. 

TNLS  example: 

BASE  C:  Reset  C:  Case  (mode)  OK: 

BASE  C: 

Character:  Reset  Character  (size  for  window)  OK:  The  command  "Reset  Character"  sets  your 
character  size  back  to  the  default  which  is  number  one.  Only  the  window  to  which  your 
mouse  is  pointing  when  you  type  OK:  will  be  affected.  This  command  will  not  work  for 
terminals  that  cannot  change  their  character  size.  See  also:  Set  Character. 

Content:  Reset  Content  (pattern)  OK:  The  command  "Reset  Content  (pattern)"  sets  aside  the 
content-analyzer  you  have  been  using.  It  is  still  available  to  you,  but  viewspecs  i  and  k  will  no 
longer  use  it  to  filter  statements.  The  Show  Status  command  in  the  programs  subsystem  will 
show  you  a  list  of  content-analyzers  that  are  available  to  you  but  not  in  force  at  the  moment. 
To  inforce  one  use  the  programs  subsystem  command  Institute. 

TNLS  example: 

BASE  C:  Reset  C:  Content  (Pattern)  OK: 

BASE  C: 

content-analyzers:  See  content-analyzer. 

Link:  Reset  Link  (default  for  file)  OK:  The  command  "Reset  Links"  resets  the  directory  for  all 
links  in  a  file  that  fail  to  specify  a  directory  to  the  default.  The  default  is  the  directory  the  file 
itself  resides  in.  This  command  is  used  after  the  Set  Link  Default  command.  If  at  any  time 
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you  are  not  sure  which  is  the  link  default  for  your  file,  use  the  Show  File  Default  (directory  for 
links)  command. 

TNLS  example: 

BASE  C:  Reset  C.  Link  (default  for  file)  OK: 

BASE  C: 

Show  File  Default  (directory  for  links)  command:  See  Show  File. 

Name:  Reset  Name  (delimiters)  OK:  The  command  "Reset  Name"  sets  the  characters  that 
define  and  mark  the  boundaries  of  statement  names  in  a  STRUCTURE  to  your  default.  See 
name-delimiters. 

TNLS  example: 

BASE  C:  Reset  C:  Name  delimiters  in  C:  Branch  at  A:  2a 

BASE  C: 

See  also:  Set  Name,  Show  Name. 

Temporary:  Reset  Temporary  (modifications  to  file)  OK:  This  command  does  not  work.  The 
command  "Reset  Temporary"  erases  all  the  temporary  modifications  and  sets  the  modification 
mode  back  to  normal  for  a  given  file.  You  may  set  the  modifications  to  a  file  to  temporary 
(with  the  command  Set  Temporary  modifications)  so  that  you  may  edit  the  file  for  your  own 
purposes  without  having  write  access.  See  also:  write,  Set  Temporary. 

TNLS  example: 

BASE  C:  Reset  C:  Temporary  (modifications  for  file)  OK: 

BASE  C: 

TTY:  Reset  TTY  (window)  OK:  The  command  "Reset  TTY"  clears  your  TTY  simulation 

window  and  replaces  the  NLS  contents  that  were  in  the  window  before  you  used  the  Set  TTY. 
See  also:  Clear. 

Viewspecs:  Reset  Viewspecs  OK:  The  command  "Reset  Viewspecs"  sets  the  viewspecs  back  to 
your  initial  set  for  NLS  sessions. 

TNLS  example: 

BASE  C:  Reset  C:  Viewspecs  OK: 

BASE  C: 

Effects:  To  list  the  viewspecs  currently  in  force,  use  the  Show  Viewspecs  status  command 
One  method  of  changing  viewspecs  is  the  Set  Viewspecs  command.  Users  can  specify 
their  initial  set  of  viewspecs  for  themselves  (the  ones  you’ll  go  back  to  when  you  reset)  in 
the  Useroptions  subsystems,  with  that  subsystems’s  Viewspecs  command  See  also: 
change.  Show  Viewspecs  (BASE),  Set  Viewspecs  (BASE),  Viewspecs 
(USEROPTIONS). 

Reset:  See  also:  Delete  (PROGRAMS). 

Buffer:  Reset  Buffer  (size)  OK:  The  Program’s  subsystem  command  "Reset  Buffer"  sets  the 
buffer  size  back  to  its  default  of  4  pages  =  2048  words. 

TNLS  example: 

PROG  C:  Reset  C:  Buffer  (size) 

PROG  C: 

NDDT:  Reset  NDDT  <CTRL-H>  OK:  The  command  "Reset  NDDT"  will  return  <CTRL-H> 
to  its  oiginal  function  which  is  the  same  as  <CTRL-A>  . 

TNLS  example: 

PROG  C:  Reset  C:  NDDT  control-h 

PROG  C: 

set  NDDT  command:  See  set  NDDT  (PROGRAMS). 
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resetting: 

resetting  an  NLS  session:  See  emergencies. 

The  reset  command  in  the  BASE  and  Useroption  subsystems:  See  Reset, 
delete  modifications  command:  See  Delete  Modifications, 
backspacing  in  commands:  See  backspacing. 

Sendmail  Initialization:  See  Initialize. 

Useroptions  reset:  See  Reset  (USEROPTIONS). 

Programs  reset:  See  Reset  (PROGRAMS). 

Calculator  clear  command:  See  Clear  (CALCULATOR). 

Restricted  Distribution:  When  the  ident  of  a  group  is  used  for  distribution  or  for 
the  author  of  a  journal  item,  you  may  restrict  distribution  to  the  co-ordinator  of 
the  group  by  typing  an  ampersand(&)  before  the  ident. 

Expanded  distribution:  See  expanded  (SENDMAIL). 

Return  ring--one  of  the  following: 

return  ring  for  files:  an  ordered  list  of  the  last  files  you  have  been  in.  Additions  to  the  ring  are 
made  "on  top"  of  the  current  position;  if  you  return  to  a  file  on  the  ring,  it  is  added  to  the 
top  of  the  list.  You  are  always  at  the  top  of  the  list;  additions  force  the  oldest  off  the  bottom 
after  established  size  is  reached.  You  can  control  the  number  of  files  kept  on  your  ring  with 
commands  in  Useroptions.  Use  .fr  (jump  to  file  return)  as  an  ADDRESS  element. 

Jump  to  File  Return  command:  5eeJump  File  Return. 

Useroptions  subsystem  commands  for  size  of  ring:  See  Filereturn 

(USEROPTIONS). 

See  also:  Statement  Return. 

Record  of  statements  within  a  single  file:  See  return. 

Return  (ring  entries)  CONTENT  OK:  The  Useroptions  subsystem  command  "Return"  allows 
you  to  change  the  maximum  size  of  your  Statement  Return  Ring.  The  default  is  10.  The 
maximum  allowed  is  25.  CONTENT  wants  the  Number  of  entries  for  the  ring.  Each  location 
remembered  on  your  ring  takes  up  space  and  too  many  could  slow  you  down  or  cause 
problems.  For  this  reason  we  recommend  no  more  than  10  except  for  special  cases. 

Effects:  The  commands  won’t  take  effect  until  you  create  a  new  window  in  DNLS  or  until 
your  next  NLS  session  in  TNLS.  They  will  remain  in  effect  for  subsequent  sessions  until 
you  change  the  size  again. 

See  also:  Useroptions  file,  file- return,  CONTENT,  Useroptions  Show  Return,  Useroptions 
Reset  Return. 

RFC  (number)  CONTENT  OK:  The  Sendmail  subsystem  command  "RFC" 
allows  you  to  use  a  reserved  RFC  number  if  you  know  the  IDENT  to  which  it  is 
reserved.  RFC  stands  for  Request  For  Comments  which  is  a  series  of  memoranda 
between  Network  Liaison  personnel  numbered  and  distributed  at  the  Network 
Information  Center.  They  are  no  longer  restricted  to  requests  for  comments. 
You  must  specify  a  title  and  author  by  the  Sendmail  Title  and  Author  commands. 

The  reserve  RFC  number  command:  5«?RFC. 

The  Reserve  command:  See  Reserve. 
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Right-anglebracket  (>)  command:  Typing  the  right-anglebracket  key  (>)  at 
the  herald  of  a  subsystem  displays  the  name  of  your  current  subsystem  —  See 
stack. 

ring:  See  bells. 

RINS:  See  journal-number, 
routine:  See  procedures. 

RPT:  OKREPEAT  prompt:  In  certain  commands  it  is  possible  to  repeat  the 
contents  of  certain  fields  from  a  previous  command  or  field,  e.g.  the  content  you 
are  searching  for  in  Jump  to  Content.  Where  such  repetition  is  possible,  full 
prompting  prompts  with  "RPT:  Normally,  you  type  <CTRL-B>  to  repeat 

use  of  the  holdover  field.  See  also:  OKREPEAT. 

RSEXEC  file:  a  file  that  shows  up  in  your  directory  surrounded  by  squarebrackets 
and  contains  the  necessary  information  for  using  RSEXEC.  RSEXEC  is  a 
subsystem  available  in  TENEX  which  allows  you  to  learn  information  about 
certain  activities  on  the  ARPANET  and  to  perform  restricted  operations  at  other 
sites. 

Run  Program/TENEX  : 

Program:  Run  Program  CONTENT  OK:  The  Program’s  subsystem  command  "Run  Program" 
transfers  control  to  the  program  you  specify  in  CONTENT.  The  program  must  be  compiled 
and  loaded  in  the  buffer.  The  first  program  compiled  or  loaded  into  the  buffer  is  number  one. 
CONTENT  accepts  the  program  name  or  its  buffer  number.  This  command  is  unnecessary  for 
userprograms  that  are  subsystems  (user-subsystems).  Treat  them  just  as  subsystems. 

The  load  program  command:  5eeload  (PROGRAMS). 

TNLS  example: 

PROG  C:  Run  C:  Program  T:  format 
COM  Formatter:  Select.... 

PROG  C: 

TENEX:  Run  TENEX  (subsystem)  CONTENT  OK:  (output  to)  OUT  (input  mode)  IN  (wait  for 
completion?)  ANSWER  (Go?)  OK: 

The  programs  subsystem  command  "Run  TENEX"  allows  you  to  operate  the  TENEX 
subsystem  you  specify  for  CONTENT  while  you  continue  working  in  NLS. 

OUT  =  File  CONTENT  lor!  Teletype  OK: 

If  you  specify  "Teletype"  for  the  output,  the  process  will  appear  on  your  terminal. 
Otherwise,  if  you  specify  "File"  the  process  will  be  remembered  in  the  sequential  file 
with  the  name  you  specify  for  CONTENT. 

IN  - 

From  (file)  CONTENT  OK:  This  commandword  allows  you  to  specify  a  sequential 
file  containing  a  stream  of  characters  which  will  be  interpreted  in  the  TENEX 
subsystem  you  specify. 

No  (input)  OK:  This  commandword  is  for  subsystems  that  do  not  need  any  user 
input  other  than  calling  the  subsystem  name. 

Typeahead  CONTENT  OK:  This  commandword  allows  you  to  specify  a  stream  of 
characters  to  be  interpreted  by  the  TENEX  subsystem.  Enter  CA  and  CD  by 
preceeding  them  with  <CTRL-V>. 

Interactive  (termination  character)  CONTENT  OK:  This  commandword  allows 
you  to  specify  the  necessary  input  characters  as  you  go  along.  When  you  get  to 
the  point  where  you  wish  to  leave  the  TENEX  subsystem  you  type  the 
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"termination  character"  you  specify  here.  <  CTRL-Y  >  is  a  good  one  to  use.  If 
you  say  "No"  to  "Wait  for  completion?",  the  TENEX  subsystem  will  continue 
until  it  is  finished  while  you  do  other  things  in  NLS.  You  can  abort  the  subsystem 
by  using  Programs  subsystem’s  Kill  TENEX  (subsystems)  command. 

Use  programs’  Kill  TENEX  (subsystem)  command  to  terminate  the  process.  Use 
programs’  Show  TENEX  command  to  see  the  current  status  of  your  TENEX 
subsystem.  See  also:  TENEX,  Kill  TENEX  (PROGRAMS),  Show  TENEX 
(PROGRAMS),  sequential. 

TENEX:  Run  TENEX  (subsystem)  CONTENT  OK:  (output  to)  OUT  (input  mode)  IN  (wait  for 
completion?)  ANSWER  (Go?)  OK: 

The  programs  subsystem  command  "Run  TENEX"  allows  you  to  operate  the  TENEX 
subsystem  you  specify  for  CONTENT  while  you  continue  working  in  NLS. 

Runabie  Programs:  SeeREL  files: 

running  programs:  The  Programs  subsystem  command  Run  Program  will  pass 
control  to  the  program.  In  such  cases,  the  program  file  will  have  the  extension 
"REL".  For  programs  with  other  extensions:  See  loading  user  programs  files. 
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S  ViewSpeC:  show  all  lines:  "Show  all  lines  of  each  statement."  This  viewspec  is 
normally  on,  but  if  you  were  previously  looking  at  one  line  only  and  you  wanted 
to  see  all  lines,  you'd  set  viewspec  s.  It  releases  any  previous  line-cutting  viewspecs 
but,  unlike  w,  does  not  show  more  levels. 

screen:  See  display. 

Search  -  one  of  the  following: 

for  character  with  ADDRESS:  See  characteraddress. 
for  word  with  ADDRESS:  See  word -search, 
pointing  in  general:  See  pointing. 

for  content  with  ADDRESS- -usually  within  one  statement  or  branch:  See 
contentaddress. 

for  content  with  viewspecs--usually  over  a  whole  file:  See  content- pattern. 

for  Statementname  with  ADDRESS:  There  are  four  basic  ways  of  searching  for  statement 
names.  These  can  be  talked  about  with  the  Jump  command.  Jump  (to)  Name  Any  takes  you 
to  a  name  the  fastest  way  possible.  If  you  have  not  changed  the  position  of  your  named 
statements  since  the  last  time  you  did  an  Update  File  Compact,  this  will  also  equal  a  Jump  (to) 
Name  First.  Jump  (to)  Name  First  and  Next  are  slower.  See  also:  statementname, 
nextname,  branchname,  externalname. 

The  Jump  (to)  Name  commands:  See  Jump  Name, 

secondary: 

recognition  mode:  See  terse. 

distribution  changed  to  "Forward"  in  Sendmail  Subsystem:  See  forward  (SENDMAIL). 

Seeing:  See  reading, 
semicolon: 

semicolon:  ;  TYPEIN  OK:  Typing  the  semicolon  character  (;  )  at  the  herald  allows  you  to  enter 
a  comment  not  taken  as  command  input. 

TNLS  example: 

BASE  C:  ;  This  next  series  of  commands  shows  how  to  .... 

BASE  C: 

Effects:  Anything  you  type  after  the  semicolon  and  before  the  OK  will  be  printed  at  your 
terminal  but  not  processed  in  any  other  way  by  NLS.  People  often  use  ;  after  the 
Connect  TTY  command,  which  "links"  two  terminals.  You  can  then  have  comments 
you  type  be  printed  at  both  terminals  without  affecting  either  job. 

See  also:  terminals,  Connect  TTY. 
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the  semicolon  as  a  viewspec:  set  off  content-analyzer  patterns  in  links:  When  the  viewspec 
field  of  links  contains  a  content-analyzer  pattern,  the  pattern  is  placed  between  semi-colons 
among  the  other  viewspecs.  For  example: 

<  address  :  viewspecs  ;  content-analysis  pattern;  viewspecs> 

If  no  other  viewspecs  are  used,  the  pattern  still  must  be  preceded  by  a  colon.  See:  pattern. 

Send  (the  mail)  OK:  The  Sendmail  subsystem  command  "Send"  sets  in  motion 
the  Sendmail  process  after  you  have  specified  correctly  a  source  and  any  other 
information  you  wish.  (If  you  put  impossible  things  in  some  fields,  it  won’t 
work.) 

types  of  sources:  See  item  (SENDMAIL). 

Sending  mail:  Use  the  Sendmail  Interrogate  command  to  be  prompted  for  the 
basic  elements  of  a  sendmail  item.  You  will  be  asked  for  a  distribution  list  made 
up  of  IDENTS. 

Interrogate  command:  See  Interrogate  (SENDMAIL). 

Sources  for  sendmail  items:  See  item  (SENDMAIL). 
error  messages  in  the  Sendmail  subsystem:  See  Initialize, 
identification  and  mailing  lists:  See  identification, 
commands  in  the  Sendmail  subsystem:  See  commands. 

sendlist:  identlist. 

Sendmail  subsystem:  The  Sendmail  subsystem  allows  you  to  send  messages  and 
documents  to  a  list  of  people  known  to  NLS  and  have  these  messages  cataloged 
and  stored  in  the  NLS  Journal.  The  recipients  may  receive  hardcopy,  or  notice  of 
*  the  item  in  their  initial  file,  or  the  item  itself  if  it  is  short. 

commands  in  the  Sendmail  subsystem: 

Authors  CONTENT  OK:  See  Authors  (SENDMAIL). 

Branch  (at)  SOURCE  OK:  See  Branch  (SENDMAIL). 

Comment  CONTENT  OK:  See  Comment  (SENDMAIL). 

Distribute  (for)  CATEGORY  (to)  CONTENT  OK:  See  Distribute  (SENDMAIL). 

Execute  (command  in)  SUBSYSTEM:  See  Execute. 

Expedite  OK:  See  Expedite  (SENDMAIL). 

File  DESTINATION  OK:  See  File  (SENDMAIL). 

Forward  (item  number)  CONTENT  (for)  ACT/INFO  (only)  ..  .:  See  Forward 
(SENDMAIL). 

Goto  SUBSYSTEM  OK:  See  Goto. 

Group  (from)  SOURCE  OK:  See  Group  (SENDMAIL). 

Offline  (item  --  located  at)  CONTENT  OK:  See  Offline  (SENDMAIL). 

OKREPEAT  <CTRL-B>:  See  OKREPEAT. 

Initialize  (specifications)  OK:  See  Initialize  (SENDMAIL). 

Insert:  See  Insert  (SENDMAIL). 

Interrogate  OK:  See  Interrogate  (SENDMAIL). 

Keywords  CONTENT  OK:  See  Keywords  (SENDMAIL). 
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Message  CONTENT  OK:  See  Message  (SENDMAIL). 

Number  Assign/Previously  See  Number  (SENDMAIL). 

Obsoletes  (item  number(s))  CONTENT  OK:  SeeObsoletes  (SENDMAIL). 

Plex  (at)  SOURCE  OK:  SeePlex  (SENDMAIL). 

Private  OK:  See  Private  (SENDMAIL). 

Process  (sendmail  form  at)  DESTINATION  OK:  See  Process  (SENDMAIL). 

Public:  See  Public  (SENDMAIL). 

Quit  OK:  See  Quit. 

RFC  (number)  CONTENT  OK:  See  RFC  (SENDMAIL). 

Reserve:  See  Reserve  (SENDMAIL). 

Send  (the  mail)  OK:  See  Send  (SENDMAIL). 

Show  Status/Record:  See  Show  (SENDMAIL). 

Statement  (at)  CONTENT  OK:  See  Statement  (SENDMAIL). 

Subcollections  CONTENT  OK:  See  Subcollections  (SENDMAIL). 

Title  CONTENT  OK:  See  Title  (SENDMAIL). 

Unrecorded  ANSWER:  See  Unrecorded  (SENDMAIL). 

Update  (to  item  number(s))  CONTENT  OK:  See  Update  (SENDMAIL). 

Reading  your  mail:  See  Reading. 

Sending  mail:  See  Sending,  Insert  Sendmail  form. 

sendmessage:  Seesndmsg. 

Sequence  Generators:  determine  the  way  in  which  the  statements  in  a  file  are 
arranged  into  a  structure  before  display.  The  usual  order  is  the  outline  structure 
you  see  when  the  file  is  printed  while  viewspec  P,  the  default,  is  on.  Users  may 
create  others.  Use  viewspec  capital-O  and  capital-P  to  turn  on  and  off  a  user 
sequence  generator.  A  sequence  generator  observes  filter  viewspecs,  i.e., 
content-analysis  and  level  clipping,  in  determining  which  statements  to  pass  on  to 
the  formatter.  Sequence  Generator  programs  are  complex  and  generally  limited 
to  experienced  L10  programmers.  None  are  currently  supported  as 
user-programs.  COMPARE:  sequential. 

sequential:  With  regard  to  computer  files  that  contain  text,  a  sequential  file  stores 
its  characters  in  a  single  sequence  like  beads  on  a  string.  NLS  files  are  not 
sequential  files,  but  rather  have  statements  stored  in  a  random  order  with  a 
system  of  pointers  to  retrieve  them  as  needed.  You  can  turn  a  sequential  file  into 
an  NLS  file  using  the  Copy  Sequential  command  and  you  can  turn  an  NLS  file 
into  a  sequential  file  using  the  Output  Sequential  command  or  the  File  alternative 
in  the  Output  Quickprint  or  Output  Printer  commands.  Sequential  files  generated 
from  NLS  files  often  have  the  extensions  .TXT  or  .Print.  See  also:  extension, 
TENEX,  PRINTER. 

Copy  Sequential  command:  5eeCopy  Sequential. 

Output  Sequential  file  command:  See  Output  Sequential. 
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Server  computer:  A  computer  providing  service  to  users  via  the  ARPANET. 
Sometimes  called  a  "Host".  See  NIC. 

Set: 

Buffer:  Set  Buffer  (size  to)  CONTENT  OK:  The  Program’s  subsystem  command  "Set  Buffer" 
allows  you  to  specify  the  number  of  pages  reserved  for  user-program  code. 

buffers:  See  buffers. 

TNLS  example: 

PROG  C:  Set  C:  Buffer  (size  to)  T:  8  pages  =  4096  words 
PROG  C: 

NDDT:  Set  NDDT  <CTRL-H>  OK:  The  command  "Set  NDDT"  allows  you  to  go  to 
NLS-DDT  when  you  type  a  <CTRL-H>. 

TNLS  example: 

PROG  C:  Set  C:  NDDT  (control-h) 

PROG  C: 

NLS-DDT:  5ee  NLS-DDT. 

reset  NDDT  control-h  command:  See  reset  NDDT  (PROGRAMS). 

Set:  The  command  "Set"  allows  you  to  change  any  one  of  the  following  things  that 
you  specify.  Use  the  Reset  commandverb  to  get  back  to  the  original  default 
setting.  See  also:  SET  (PROGRAMS),  RESET . 

Archive:  Use  the  BASE  subsystem’s  Archive  command:  See  archive. 

Character:  Set  Character  (size  for  window  to)  CONTENT  OK:  The  command  "Set  Character" 
allows  you  to  change  the  size  of  your  characters  to  one  of  the  numbers  (shown  below)  you 
specify  for  CONTENT.  Character  size  1  is  the  default.  Only  the  window  to  which  your 
mouse  is  pointing  when  you  type  OK:  will  be  affected.  This  command  will  not  work  for 
terminals  that  cannot  change  their  character  size.  See  also:  Reset  Character. 

0  The  smallest. 

1  The  average  size  (72  characters  per  line)  the  default. 

2  The  large  size. 

3  The  largest  size. 

Content:  Set  Content  (pattern)  Off/On/To  ... 

Off:  Set  Content  (pattern)  Off  OK:  The  command  "Set  Content  (pattern)  Off"  de-activates 
your  content-analysis  pattern  by  turning  viewspec  j  on.  All  statements  will  pass. 
Viewspec  i  or  the  command  "Set  Content  (pattern)  On"  activates  your  content-analysis 
pattern. 

viewspec  j:  See  j. 

content-analyzers:  See  content-analyzer. 

Set  Content  (pattern)  On  (Base  command):  See  Set  Content  (BASE). 

On:  Set  Content  (pattern)  On  OK:  The  command  "Set  Content  (pattern)  On"  activates 
your  current  content-analysis  pattern  by  turning  viewspec  i  on.  Only  statements  that 
contain  the  current  pattern  will  pass.  Viewspec  j  or  the  BASE  subsystem  command  "Set 
Content  (pattern)  Off"  de-activates  your  content-analysis  pattern. 

viewspec  i:  See  i. 

content-analyzers:  See  content-analyzers. 
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Reset  Content  (pattern):  See  Reset  Content. 

To:  Set  Content  (pattern)  To  CONTENT  OK:  The  command  "Set  Content  (pattern)  To" 
allows  you  to  type  in  or  point  to  a  content-analyzer  pattern.  It  then  compiles  the  pattern 
and  makes  it  your  current  content-analyzer.  After  you  specify  the  content-analyzer 
pattern,  you  may  turn  it  off  and  on  by  the  viewspecs  i,  j,  and  k.  When  pointing  to  a 
pattern  instead  of  typing  it  in,  you  must  point  to  the  first  character  of  the  entire  pattern 
which  must  end  with  semicolon.  Content-analyzer  programs  already  compiled  into  a 
program  file,  can  be  loaded  with  the  Programs  subsystem  command  "Load  Program". 

content-analysis  viewspecs:  ,See  content-analysis. 

The  Programs  subsystem  Load  Program  command:  See  load  (PROGRAMS). 

Directive:  Set  Directive  (Filter)  OK:  The  Format  user-subsystem  command  "Set  Directive"  sets 
your  current  content-analyzer  filter  to  one  which  only  shows  statements  with  Output  Processor 
directives  in  them.  You  may  then  use  viewspec  i  to  turn  the  filter  on,  and  viewspec  j  to  turn  it 
off  (show  everything). 

Delimiters  alternative:  If  directives  in  the  file  you  are  working  on  use  delimiters  other 
than  period  and  semicolon  (because  you  changed  the  delimiters  in  a  preceeding 
statement),  you  must  use  the  command: 

Set  Directive  (Filter)  Delimiters  (Left)  CONTENT  (Right)  CONTENT  OK: 

Typein  or  point  to  the  left  and  right  directive  delimiter  characters  which  you  wish  the 
program  to  use.  Each  new  view  of  the  file  (a  Jump  or  Print)  through  this  filter  begins 
with  the  assumption  that  the  directive  delimiters  are  these  new  characters.  Changes  in 
the  delimiters  by  subsequent  directives  in  the  view  will  not  keep  them  from  being  viewed. 

External:  Set  External  (names  link  file  to:)  CONTENT  OK:  To  use  this  command,  you  must 
have  a  file  that  contains  statement  names  followed  by  links.  Specify  this  file’s  name  for 
CONTENT.  See  also:  Jump  Name,  EXTERNALNAME. 

Link:  Set  Link  (default  for  file  to  directory)  CONTENT  OK.  The  command  "Set  Link"  allows 
you  to  change  the  operation  of  links  in  a  specific  file  so  they  work  as  if  the  named  directory 
were  in  the  link.  Then,  when  you  do  not  specify  a  directory  name  for  links  in  that  file,  the  one 
you  have  chosen  will  be  assumed.  You  can  go  back  to  the  default  set  by  the  system  prior  to 
this  command-the  directory  the  file  itself  resides  in-by  using  the  Reset  Link  default  command. 
See  also:  defaults. 

TNLS  example: 

BASE  C:  Set  C:  Link  (default  for  file  to  directory)  T:  alice 

BASE  C: 

Reset  Link  (default)  command:  See  Reset  Link. 

Show  File  Default  (directory  for  link)  command:  See  Show  File  Default  (BASE). 

Name:  Set  Name  (delimiters  in)  STRUCTURE  (at)  DESTINATION:  (left  delimiter)  CONTENT 
(right  delimiter)  CONTENT  OK: 

The  command  "Set  Name"  allows  you  to  change  the  characters  which  define  and  mark  the 
boundaries  of  statement  names  in  a  particular  STRUCTURE  at  the  DESTINATION  you 
specify.  Typein  or  point  to  one  character  as  the  CONTENT  for  both  the  left  and  right 
delimiters.  It  will  only  take  effect  on  those  statements  passing  the  current  viewspecs.  See  also: 
statementname,  STRUCTURE,  Reset  Name,  Show  Name. 

TNLS  example: 

BASE  C:  Set  C:  Name  (delimiters  in)  C:  Branch  at  A:  2a 

left  delimiter  T: 

right  delimiter  T:  : 

BASE  C: 
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Effects:  See  name-delimiters. 

NLS:  Set  NLS  (protection  for  file)  Private/Public  OK: 

Private:  Set  NLS  (protection  for  file)  Private  OK:  The  command  "Set  NLS  (protection  for 
file)  Private"  allows  you  to  limit  access  to  the  file  in  which  you  are  currently  located. 
Only  those  people  with  their  IDENTS  listed  in  the  origin  statement  of  the  file  in  exactly 
the  following  syntax:  AccessList:  IDENTLIST;  will  be  allowed  to  see  the  file.  The 
word  AccessList  must  be  followed  by  a  colon  (:)  and  a  space  before  you  list  the 
IDENTS.  The  list  of  IDENTS  must  be  all  capitals,  separated  by  commas,  and  with  a 
semi-colon  (;  )  at  the  end.  After  inserting  the  AccessList,  and  setting  the  protection  to 
private,  you  must  update  the  file  "before  the  protection  will  work.  If  you  do  not  put  the 
AccessList  outside  the  delimiters  of  the  origin  statement,  it  will  disappear  when  you 
update.  NOTE,  if  you  make  a  mistake,  you  can  easily  deny  access  to  yourself.  If  this 
occurs,  one  of  your  computer’s  operators  should  be  able  to  bail  you  out.  See  also: 
statement,  Set  NLS  Public,  Show  File  Status. 

Effects:  A  NULL  AccessList  (i.e.,  one  which  is  specified  but  has  no  idents  in  it)  is 
very  different  from  a  nonexistent  AccessList.  The  former  grants  access  to  no  one; 
the  latter  effectively  grants  access  to  everyone.  An  unauthorized  user’s  attempt  to 
load  a  private  file  is  declined  by  NLS  with  the  message:  "Private  file:  access 
denied  to  you."  Once  a  file  has  been  Set  Private,  it  remains  private  until  it  is 
specifically  set  Public.  When  a  new  file  is  created,  it  is  Public. 

Public:  Set  NLS  (protection  for  file)  Public  OK:  The  command  "Set  NLS  (protection  for 
file)  Public"  makes  the  file  in  which  you  are  presently  located  open  to  anyone.  Set  NLS 
Public  undoes  what  the  Set  NLS  Private  command  does  but  is  independant  of  the  Set 
TENEX  (protection)  command. 

Temporary:  Set  Temporary  (modifications  to  file)  OK:  (really?)  OK: 

The  command  "Set  Temporary"  allows  yout  to  edit  a  file  for  your  own  purposes  without 
having  write  access  (e  g.  journal  files).  Reset  Temporary  modifications  erases  all  the  temporary 
modifications  and  sets  the  modification  mode  back  to  normal  for  the  given  file. 

TNLS  example: 

BASE  C:  Set  C:  Temporary  (modifications  for  file)  OK: 

BASE  C: 

DANGER:  The  command  "Reset  Temporary"  does  not  work  at  all.  Be  sure  you 

understand  the  "Set  Temporary"  command  before  you  use  it. 

write  access:  See  write, 
modifications:  See  modifications. 

Reset  Temporary  (modifications  for  file)  command:  See  Reset  Temporary. 

TENEX:  Set  TENEX  (protection  for  file  named)  CONTENT  CONTROLS  OK: 


TTY:  Set  TTY  (simulation  for  window)  BUG  OK:  The  command  "Set  TTY"  allows  you  to 
BUG  the  DNLS  window  you  wish  to  have  simulate  a  teletype.  You  will  want  to  use  the  Insert 
Edge  command  first  to  create  a  special  window.  See  also:  TTY-simulation. 

Viewspecs:  Set  Viewspecs  VIEWSPECS  OK:  The  command  "Set  Viewspecs"  allows  you  to 
change  the  viewspecs  at  any  time  for  the  current  NLS  session. 

TNLS  example: 

BASE  C:  Set  C:  Viewspecs  V:  dmtGy 
BASE  C: 

Effects  and  related  commands:  To  list  the  viewspecs  currently  in  force  for  this  session, 
use  the  Show  Viewspecs  command.  After  this  NLS  session,  your  viewspecs  will  revert  to 
a  default  initial  set  which  you  can  select  for  yourself  in  the  Useroptions  subsystem,  with 
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the  Viewspecs  and  Reset  Viewspecs  commands.  To  check  what  initial  set  is  established, 
use  Useroptions’  Show  Viewspecs  command.  Base’s  Reset  Viewspecs  command  will 
return  current  viewspecs  to  that  same  initial  set  immediately.  See  also:  Reset 
Viewspecs  (BASE),  Show  Viewspecs  (BASE),  Viewspecs  (USEROPTIONS),  Reset 
Viewspecs  (USEROPTIONS),  Show  Viewspecs  (USEROPTIONS). 

.SG;  Sequence  Generator  program:  filename  with  this  extension  points  to  a 
compiled  L10  Sequence  Generator.  The  Load  Program  command  in  the 
Programs  subsystem  will  place  the  Sequence  Generator  in  your  buffer  and 
automatically  institute  it  as  your  current  Sequence  Generator  replacing  any  other 
Sequence  Generator  that  might  be  there. 

Sequence  Generators:  See  sequence, 
shared  screens:  See  connect  display. 

Show:  The  command  "Show"  does  different  things  and  has  different  alternative 
operands  in  different  subsystems.  See  also:  verb,  operand,  SUBSYSTEM. 

Base  Show:  5eeShow  (BASE). 

Sendmail  Show:  See  Show  (SENDMAIL). 

Useroptions  Show:  See  Show  (USEROPTIONS). 

Programs  Show  Status:  5eeShow  (PROGRAMS). 

Sendmail  Show  Record  (for)  IDENT  OK:  5eeShow  Record  (SENDMAIL). 

Calculator  Show:  5eeShow  (CALCULATOR). 

Show:  see  the  status  of  special  things:  The  command  "Show"  allows  you  to  see 
the  status  of  any  one  of  the  following  things  that  you  specify.  See  also:  reading, 
viewing. 

Directory:  Show  Directory  (of)  DEFAULT  [DIROPT]  OK:  DEFAULT  -  OK  !to  specify  the 
directory  to  which  you  are  connected! 
lor!  CONTENT  laccepts  any  FILEADDRESS! 

The  command  ’’Show  Directory"  will  display  a  list  of  files  in  link  syntax  according  to  options  you 
can  specify  with  commandwords  in  DIROPT  after  you  type  <CTRL-U>.  You  can  insert  the 
list  into  a  file  with  the  Copy  Directory  command.  If  the  file  is  being  modified,  it  will  state  this 
in  square  brackets  following  the  link  syntax  for  that  file.  See  also:  directory,  option, 
comrnandword,  link. 

DIROPT:  See  DIROPT. 

Copy  Directory  command:  See  Copy  Directory. 

TNLS  example: 

BASE  C:  Show  C:  Directory  T:  kabinett,*.NLS;* 

OPT : / OK:  OK: 

<KABINETT> 

XXX.NLS;9 

•  •  ■ 

BASE  C: 

Effects:  Altmode  works  when  specifying  a  FILEADDRESS.  If  the  FILENAME  is  not 
specified,  all  files  in  the  directory  to  which  you  are  connected  (the  one  you  logged  in 
under  or  subsequently  Connected  to)  will  be  printed. 

filename  and  star  convention:  See  star. 

Connect  to  Directory  command:  See  Connect  Directory. 
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Disk:  Show  Disk  (space  status)  OK:  The  command  "Show  Disk  (space  status)"  will  print  the 
number  of  disk  pages  in  use  for  deleted  and  undeleted  files,  and  the  maximum  number  of  disk 
pages  allowed  for  your  directory.  It  also  shows  how  many  pages  are  in  use  by  the  whole 
system,  and  how  many  are  left. 

deleted  files:  See  deleted 

TNLS  example: 

BASE  C:  Show  C:  Disk  (space  status)  OK: 

Connected  to  WEINBERG 

93  Total  pages  in  use  --  300  Allowed,  93  Undeleted,  0  Deleted 
System  Total:  3246  Pages  left,  55604  Used 
BASE  C: 

Return:  Show  Return  (ring)  OK:  The  command  "Show  Return  (ring)"  will  show  the  beginnings 
of  the  last  few  statements  where  you  have  been.  The  most  recent  statements  you  visit  are 
added  in  turn  to  the  top  of  the  list.  To  change  the  size  of  your  return  ring  (from  the  default 
10  to  up  to  25)  use  Useroptions  Return  command.  See  also:  return. 

TNLS  example: 

BASE  C:  Show  C:  Return  (ring)  OK: 
so  we  left  for  the  mountain 
and  so  on 
an  extraxterrestria 
buffalo  consider. 

BASE  C: 


File: 


Default:  Show  File  Default  (directory  for  links)  OK:  The  command  "Show  File  Default" 
will  print  the  link  default  directory  for  the  file  you  are  in.  This  command  has  no  effect 
on  the  file.  The  link  default  directory  may  be  changed  with  the  Set  Link  command. 

TNLS  example: 

BASE  C:  Show  C:  File  C:  Default  (directory  for  links)  OK: 

Private  File  (but  with  no  Access  List) 

<  WEINBERG,  RE.NLS;16,  > 

Default  directory  for  links  is  WEINBERG 

BASE  C: 

Modification:  Show  File  Modification  (status)  OK:  The  command  "Show  File 

Modification"  will  print  the  modification  status  of  the  loaded  file.  The  first  creation  or 
change  of  text  begins  a  set  of  modifications  and  changes  the  modification  status  to 
modified.  Normally,  only  one  person  can  be  modifying  a  file  at  any  time.  The  file 
modification  status  remains  "modified"  until  you  incorporate  your  changes  into  the  file 
with  a  Update  command.  See  also:  modifications,  Update. 

TNLS  example: 

BASE  C:  Show  C:  File  C:  Modifications  (status)  OK: 

<  WEINBERG,  RE.NLS;1 7,  > 

Being  Modified  By  WEINBERG  (POOH) 

BASE  C. 

Return:  Show  File  Return  (ring)  OK:  The  command  "Show  File  Return"  will  show  your 
file  return  ring.  The  most  recent  files  you’ve  worked  in  (in  this  NLS  session)  have  been 
added  in  turn  to  the  top  of  the  list;  the  file  you’re  in  is  at  the  top.  To  change  the  size  of 
your  return  ring  (from  the  default  10  to  up  to  25)  use  Useroptions’  Fileretum  command. 
See  also:  Jump  File  Return. 

TNLS  example: 

BASE  C:  Show  C:  File  C:  Return  (ring)  OK: 

<  WEINBERG,  RE. NLS;  17,  >  Being  Modified  By  WEINBERG  (POOH) 
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<  WEINBERG,  P00H.NLS;61,  >  Being  Modified  By  WEINBERG  (POOH) 

BASE  C: 

Size:  Show  File  Size  OK:  The  command  "Show  File  Size"  will  print  information  about  the 
size  of  the  file  in  which  you  are  located.  It  refers  to  TENEX  pages  which  are  roughly 
equivalent  to  typed  pages. 

TNLS  example: 

BASE  C:  Show  C:  File  C:  Size  OK: 

<  DOE  >  WONDER.  NLS;  34 
31  statements  in  file 
Structure  pages  =  1/95 
Data  pages  =  1/370 
Total  pages  in  file  =  8 

1402  words  used  out  of  2048  words  in  file  (  =68%) 

BASE  C: 

Status:  Show  File  Status  OK:  The  command  "Show  File  Status"  will  print  certain  basic 
information  about  the  loaded  File,  including:  link  default  directory,  modification  status, 
date  of  creation,  and  file  size.  This  command  has  no  effect  on  the  file.  See  also: 
loading,  modifications. 

TNLS  Example: 

BASE  C:  Show  C:  File  C:  Status  OK: 

<  WEINBERG, RE. NLS;16,  > 

being  Modified  By  WEINBERG  (POOH) 

Private  File  (but  with  no  Access  List) 

Default  directory  for  links  is  WEINBERG 

Creation  date  of  version  1:  14-JAN-75  08:03 

Creation  date  of  this  version:  6-FEB-75  15:14 

26  statements  in  file 

Structure  pages  =  1/95 

Data  pages  =  6/370 

Total  pages  in  file  =  8 

1101  words  used  out  of  4096  words  in  file  (=27%) 

Try  an  Update  File  Compact  to  improve  %  used. 

Market':  Show  Marker  (list)  OK:  The  command  "Show  Marker"  will  list  the  markers,  with  their 
addresses,  of  the  loaded  file. 

Effects:  Markers  are  normally  invisible  when  viewing  your  file.  Markers  are  named  with 
the  Mark  Character  command,  and  deleted  with  the  Delete  Marker  or  Delete  All 
markers  commands. 

pointing  with  a  marker:  You  can  point  to  a  marked  character  by  using  the  marker  name 
in  an  ADDRESS  expression.  You  can  also  point  there  in  DNLS  by  holding  down  the 
right-most  button  on  the  mouse  and  typing  in  the  marker.  See  also:  buttons,  down. 

See  also:  markers,  Mark,  Delete  Marker,  Delete  All. 

Name:  Show  Name  (delimiters  for  statement  at)  DESTINATION  OK:  The  command  "Show 
Name"  will  print  the  characters  currently  defined  (by  the  Set  and  Reset  Name  delimiters 
commands  or  by  your  useroptions  default)  to  mark  off  statementnames  for  the  statement  you 
specify. 

TNLS  example: 

BASE  C:  Show  C:  Name  (delimiters  for  statement  at)  A:  1 
NULL  NULL 
BASE  C: 

See  also:  statementname,  name-delimiters. 


140 


Nl.S-X 


s 


ViewspecS:  Show  Viewspecs  (status)  [Verbose]  OK:  The  command  "Show  Viewspecs"  will  (in 
the  terse  form)  simply  list  the  viewspecs  in  force  in  the  current  NLS  session.  In  the  verbose 
form,  it  will  list  the  viewspecs  with  their  meanings. 

TNLS  example: 

BASE  C:  Show  C:  Viewspecs  (status)  OK/  [  **  ] : 

levels:  ALL,  lines:  ALL,  hjnpuzACEGJLP 

BASE  C: 

Effects:  For  verbose,  type  the  OPTION  character  and  then  specify  the  commandword 
Verbose  before  confirming  the  command.  The  Set  and  Reset  Viewspecs  commands  are 
used  to  change  viewspecs.  See  also:  change,  Set  Viewspecs  (BASE),  Reset  Viewspecs 
(BASE). 

Show  Status/Record. 

Record:  Show  Record  (for  ident)  CONTENT  OK.  The  Sendmail  subsystem  command 
"Show  Record"  takes  an  IDENT  and  ident-search-codes  for  CONTENT  and  then 
displays  current  information  in  the  Identfile  about  that  person. 

IDENT:  See  ident. 

Status:  Show  Status  OK:  The  Sendmail  subsystem  command  "Show  Status"  displays  to 
you  what  it  knows  about  the  current  journal  item  to  be  sent.  It  shows  the  fields  along 
with  their  current  values.  Empty  fields  are  omitted.  You  may  replace  or  add  to  the 
items  in  this  list  with  the  appropriate  command.  You  may  also  use  the  Insert  Status 
(form)  command  to  place  the  status  as  a  statement  in  a  file  where  you  may  then  modify 
or  add  to  fields  that  can  then  all  be  processed  at  once  with  the  Process  (sendmail  form) 
command. 

The  Insert  Status  (form)  command:  See  Insert  Status  (SENDMAIL). 

The  Process  (sendmail  form)  command:  See  Process  (SENDMAIL). 


Show: 

All:  The  Useroptions  subsystem  command  "Show  All"  lists  all  your  useroptions  settings. 

Control:  Show  Control  (characters  for  terminal)  TERMINALS  OK:  The  Useroptions  subsystem 
command  "Show  Control"  prints  a  list  of  the  control-characters  or  special  characters  assigned 
to  certain  Command  Control  Functions  for  a  given  brand  of  terminal,  and  the  echo  they  feed 
back. 

TNLS  example 

USER  C:  Show  C:  Control  (characters  for  terminal)  C:  Ti  (Terminal)  OK: 

Control  Characters:  Standard  Definitions  (non-alterable) 

CA:<tD>,  CD:<  T X>,  RPT:<tB>,  INSERT:<tE>,  BC:<tA>,  BW:<tW>, 

BS:<  T  Q>,  LITESC:<  T  V>,  IGNORED  t  $>,  SC:<  t  $>,  SW:<  t  $>,  TAB:<  1 1> 

Control  Characters:  User  Definitions  (alterable) 

TI/EXECUPORT  :  [  <EOL>,<NUL>  ] 

USER  C: 

Effects:  If  you  specify  a  particular  device  for  TERMINALS,  you  will  get  a  list  of 
definitions  for  the  functions  you  have  changed  for  that  terminal  only.  If  you  specify 
"All"  for  TERMINALS,  you  will  get  a  list  of  the  standard  control  function  definitions 
users  can’t  alter  and  a  list  of  the  alterable  definitions  currently  in  effect  for  all  terminals 
using  TNLS  or  DNLS,  whichever  you’re  in.  Within  the  squarebrackets,  the  second 
character  in  anglebrackets  refers  to  the  echo,  the  character  that  prints  when  the  function 
is  used.  The  Control  command  and  the  Reset  Control  command  change  alterable  control 
function  assignments. 

TERMINALS  =  Ti  (terminal)  or  Tasker  or  NVT 
or  Lineprocessor  or  Imlac  or  Execuport 
or  33-TTY  or  35-TTY  or  37-TTY  or  All. 
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NVT  means  "Netword  Virtual  Terminal". 

Specifying  Tasker,  Imlac,  or  Line  processor  will  set  up  definitions  only  for  the  use  of  DNLS 
from  that  terminal.  All  others  set  up  definitions  for  TNLS.  If  you  type  TNLS  from 
TENEX  on  one  of  those  display  terminals,  you’ll  get  the  character  set  for  Ti.  Going  into 
TNLS  via  the  NLS  Simulate  command  gets  you  the  set  for  the  terminal  you  specify. 


CONTROLFUNCTIONS:  Command  Control  Functions: 

Ca  =  Command  Accept  (See  also:  CA) 

Cd  =  Command  Delete  (See  also:  CD) 

Rpt  =  OKREPEAT  (5ee  also:  OKREPEAT) 

Insert  =  OKINSERT  (See  also:  OKINSERT) 

Be  =  Backspace  Character  (See  also:  Backspace) 

Bw  =  Backspace  Word  (See  also:  Backspace) 

B  s  =  Backspace  Statement-erases  whole  TYPEIN  field 

L  i  t  e  s  c  =  Literal  Escape  means:  "Take  the  character  which 
follows  as  literal  text  instead  of  its  special 
function." 

Ignore  =  NLS  will  always  ignore  the  character  defined 
for  Ignore,  as  if  it  had  never  been  typed 
Sc  -  Shift  Character  (for  an  upper-case-only  terminal 

being  used  for  upper/lower  case) 

Sw  =  Shift  Word  (for  an  upper-case-only  terminal 

being  used  for  upper/lower  case) 

Tab  =  (See  also:  TAB) 


See  also:  control -characters, 

Useroptions  Reset  Control,  Useroptions  Control. 


Currentcontext:  Show  Currentcontext  OK:  The  Useroptions  subsystem  command  "Show 

Currentcontext"  shows  how  many  characters  will  surround  the  character  you  are  located  at  in 
response  to  typing  a  Slash.  See  also:  ADDRESS. 

TNLS  example: 

USER  C:  Show  C:  Currentcontext  OK: 
length:  0. 

Effects  of  Other  commands:  If  the  number  has  not  been  changed  with  the 
Currentcontext  command,  it  will  remain  at  7,  the  default.  If  you  do  use  the 
Currentcontext  command  to  change  the  currentcontext  length,  you  can  return  to  7 
characters  with  the  Reset  Currentcontext  command.  See  also:  Currentcontext 
(USEROPTIONS),  Reset  Currentcontext  (USEROPTIONS). 

Slash:  See  slash . 


Default:  Show  Default  (subsystems  and  programs)  OK:  The  Useroptions  subsystem  command 
"Show  Default"  shows  the  list  of  subsystems  that  is  automatically  loaded  and  the  one  you  will 
be  placed  in  when  you  enter  NLS.  You  can  add  to  this  list  using  Useroptions  Include 
command.  Subtract  from  the  list  by  using  Useroptions  Exclude.  Specify  the  entry  subsystem 
with  Useroptions  Entry  command.  See  also:  Include  (USEROPTIONS),  Exclude 

(USEROPTIONS),  Entry  (USEROPTIONS),  SUBSYSTEM,  Programs. 

TNLS  example: 

USER  C:  Show  C:  Default  (Subsytems  and  Programs)  OK: 

Universal  Subsystem:  SUPERVISOR 

Entry  subsystems.  BASE 

Other  Subsystems  and  User  Programs:  USEROPTIONS  SENDMAIL  PROGRAMS  USER  C: 

Feedback:  Show  Feedback  OK:  The  Useroptions  subsystem  command  "Show  Feedback"  shows 
whether  your  feedback  mode  is  Verbose  (noisewords  appear  in  the  feedback  of  commands)  or 
Terse  (noisewords  will  be  shut  ofT)  and  shows  the  current  values  for  Length  and  Indenting. 

TNLS  example: 
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USER  C:  Show  C:  Feedback  OK: 
mode:  VERBOSE,  length:  50  indenting:  0 
USER  C: 

Effects  of  Other  commands:  If  the  mode  has  not  been  set  to  Terse  with  the  Feedback 
command  or  if  it  has  been  reset  with  Reset  Feedback  Mode,  it  will  be  Verbose. 
Indenting  has  to  do  with  where  commands  appear  on  TNLS  paper,  not  with  levels. 

See  also:  command,  commandword,  noiseword,  TNLS,  Useroptions  Feedback, 

Useroptions  Reset  Feedback. 

Herald:  Show  Herald  OK:  The  Useroptions  subsystem  command  "Show  Herald"  shows  you  the 
herald  mode  and  length  currently  set  for  your  TNLS  use.  You  can  learn  this  in  DNLS  too, 
although  heralds  only  appear  in  TNLS. 

What  you’ll  see  and  what  it’ll  mean  to  you  in  TNLS:  Terse  mode  means  that  a  star  * 
will  print  at  the  left  margin  for  each  command  as  your  herald  in  every  subsystem. 
Verbose  mode  means  that  part  of  the  name  of  your  current  subsystem  will  print  as  your 
herald.  The  number  of  characters  of  the  subsystem  name  that  will  print  is  shown  as 
"length"  (i.e.,  "mode:  VERBOSE  length:  3"  means  that  your  herald  for  Programs  will 
be  PRO,  for  Base,  it’ll  be  BAS,  etc.). 

related  commands:  To  change  your  heralds  for  TNLS,  use  the  Useroptions  Herald 
command.  To  return  to  the  defaults,  mode:  VERBOSE  length:  4,  use  Reset  Herald. 
See  also:  Herald  (USEROPTIONS),  Reset  Herald  (USEROPTIONS). 

Name:  USEROPTIONS  Show  Name  (delimiter  defaults)  OK:  The  Useroptions  subsystem 

command  "Show  Name"  will  display  your  default  statementname  delimiters.  See  name 
(USEROPTIONS),  statementname. 

TNLS  example: 

USER  C:  Show  C:  Name  (delimiter  defaults)  OK: 

NULL  NULL 
USER  C: 

Return:  Show  Return  (ring  sizes)  OK:  The  Useroptions  subsystem  command  "Show  Return" 
shows  you  the  maximum  size  of  your  Statement  Return  Stack  (shown  as  "return"),  and  your 
File  Return  Stack  (shown  as  "fileretum")  which  is  going  to  take  effect  the  next  time  you 
create  a  new  window  in  DNLS  or  the  next  time  you  enter  NLS.  It  will  also  be  the  current 
maximum  size  of  the  ring  if  you  haven’t  changed  it  this  session.  You  can  change  your  return 
ring  sizes  with  the  following  commands:  Useroptions  Return,  Useroptions  Fileretum, 
Useroptions  Reset  Return. 

TNLS  example: 

USER  C:  Show  C:  Return  (ring  sizes)  OK: 
return:  10  fileretum:  10 
USER  C: 

PrintoptionS:  Show  Printoptions  OK:  The  Useroptions  subsystem  command  "Show 

Printoptions"  will  show  the  present  values  for  the  four  parameters  for  TNLS  Print  commands 
used  with  viewspec  E,  the  tabstops,  and  the  number  of  spaces  set  for  level  indenting.  For  the 
meanings  and  effects  of  these  specifications,  See  also:  command:  Useroptions  Printoptions. 

TNLS  example: 

USER  C:  Show  C:  Printoptions  OK: 

Margins  left:  0  right:  72  bottom:  63 
page  size.  66  indenting  per  level:  3 
tabstops:  8,16,24,32,40,48,56,64,72,80,88,96,104 
USER  C: 

Prompt:  Show  Prompt  OK:  The  Useroptions  subsystem  command  "Show  Prompt"  shows  your 
current  mode  for  prompts. 
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TNLS  example: 

USER  C:  Show  C:  Prompt  OK: 
mode:  FULL 
USER  C: 

What  the  prompting  modes  mean:  Seepmode. 

related  commands:  The  Prompt  command  sets  the  mode  to  Off  or  Partial  or  Full.  The 
Reset  Prompt  command  returns  the  prompting  mode  to  Partial,  the  default.  See  also: 
Reset  Prompt  (USEROPTIONS),  Prompt  (USEROPTIONS). 

Recognition:  Show  Recognition  OK:  The  Useroptions  subsystem  command  "Show 

Recognition"  shows  your  current  commandword  recognition  mode:  Fixed,  Demand, 

Anticipatory,  or  Terse.  If  it  is  Terse,  you  will  also  see  the  secondary  recognition  mode. 

TNLS  example: 

USER  C.  Show  C:  Recognition  OK: 
mode:  TERSE  secondary  mode:  TERSE 
USER  C: 

meanings  of  recognition  and  recognition  modes--:  See  recognition. 

related  commands:  To  change  your  recognition  mode,  use  the  command  Useroptions 
Recognition.  The  command  to  return  to  the  beginner’s  default  mode--Fixed*-is 
Useroptions  Reset  Recognition. 

Viewspecs:  Show  Viewspecs  OK:  The  Useroptions  subsystem  command  "Show  Viewspecs" 
shows  you  the  default  viewspecs  initially  set  to  be  in  force  in  your  NEXT  and  subsequent  NLS 
sessions,  and  you’ll  see  whether  the  Viewspec  feature  is  On  or  OfT,  that  is,  available  in 
appropriate  commands,  or  unavailable  and  invisible.  (This  has  effect  in  the  CURRENT  and 
subsequent  NLS  sessions.)  It  might  look  something  like  this: 
levels:  ALL  lines:  ALL  hjmpuyBCEHJLP  Viewspec  prompting:  Off. 

related  commands:  For  changing  this  initial  set  of  Viewspecs,  See  also:  commands: 
Useroptions  Viewspecs,  Useroptions  Reset  Viewspecs.  Base’s  Show  Viewspecs  command 
(See  also:  Show  Viewspecs  (BASE))  lists  the  VIEWSPECS  presently  in  force  that  may 
be  changed  with  Base  commands.  See  also:  Set  Viewspecs  (BASE),  Reset  Viewspecs 
(BASE). 

Show  Status/TENEX  ...  :  The  Programs’  subsystem  command  "Show  Status" 
allows  you  to  determine  the  status  of  your  programs. 

Status:  Show  Status  (of  programs  buffer)  OK:  Lists  all  programs  loaded  and  instituted,  and  your 
current  buffer  size. 

loading:  See  loading. 

instituting:  See  instituting. 

TNLS  example  of  show: 

PROG  C:  Show  C:  Status  (of  programs  buffer)  OK: 

Stack  of  compiled  programs  (first  is  #1): 

Message 

Content  Analyzer  program  for  display  area:  None 
Sequence  Generator  program  for  display  area:  None 
Sort  Key  Extractor  program  for  display  area:  None 
Current  buffer  size:  6  pages  =  3072  words. 

Room  left  in  buffer:  2954  words. 

BASE  C: 

TENEX:  Show  TENEX  (subsystem  status)  OK:  The  Program’s  subsystem  command  "Show 
TENEX"  will  tell  you  if  you  have  any  TENEX  subsystems  running.  See  TENEX. 
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Show: 

Accumulator:  Show  Accumulator  (Registers)  OK:  See  also:  accumulator. 

File  (DNLS  only):  Show  File  (in  window)  DESTINATION  OK:  See  also:  file  (CALCULATOR). 

showing:  see  also:  show:  See  reading. 

SID:  Statement  IDentifier:  012  (no  preceding  character):  unique  numbers  that 
are  assigned  by  the  system  to  statements  in  a  file  in  the  order  in  which  they  are 
created.  A  SID  is  a  number  always  beginning  with  a  zero  (0).  It  remains  with 
its  corresponding  statement  for  the  life  of  the  statement  (despite  editing  changes). 
You  can,  however,  renumber  a  file’s  SIDs  consecutively  with  the  Renumber 
command  ( See  also:  Renumber).  Every  statement  is  also  separately  numbered 
according  to  its  position  in  the  file  hierarchy  (See  also:  statementnumber).  Use 
viewspecs  capital-I  and  m  to  turn  on  SIDs.  You  may  also  name  statements  (See 
also :  statementname).  Such  identifiers  of  statements  automatically  refer  to  its 
first  character  when  used  in  an  ADDRESS.  See  also:  ADDRESS,  capital-1,  m. 

signatures:  statement  signatures:  See  Capital-K. 

Simple  Startup:  The  instructions  for  simple  startup  acsume  the  Lineprocessor  is 
either  wired  or  connected  by  a  modem  without  acoustic  coupler  to  a  TIP.  If 
these  assumptions  are  false  for  your  workstation,  you  need  to  study  the 
Lineprocesor  User’s  Guide. 

STEP-1  Turn  on  the  display  with  its  ON-OFF  switch. 

STEP-2  Turn  the  display  to  "online"  or  "receive"  mode  if  this  does  not  happen  automatically. 
Make  sure  the  terminal  is  in  full  duplex  mode. 

STEP-3  On  the  Lineprocessor,  make  sure  all  the  sense  switches  (the  slim  silver  toggles  on  the  upper 
right)  are  down. 

STEP-4  If  the  telephone  modem  is  not  on,  turn  it  on. 

STEP-5  Turn  on  the  Lineprocessor  with  the  ON-OFF  button  toward  the  lower  right  and  press  the 
System  Reset  button. 

Note:  At  this  point  the  display  cursor  (on  most  displays  a  small  line  like  a  hyphen)  should 
move  when  you  move  the  mouse.  If  it  doesn’t,  first  press  the  System  Reset  button,  center  top. 
If  that  doesn’t  work,  check  the  connections  described  under  setup  in  the  Line  Processor  Users’ 
Guide.  The  error  light  does  not  indicate  a  problem  at  this  stage.  If  it  comes  on,  turn  it  off  by 
pressing  the  Error  Reset  button  just  to  its  left.  The  status  lights  should  read  0X00. 

Step-6  Type  "@  SPACE  I  SPACE  25  CARRIAGE  RETURN"  unless  the  port  you  are  using  to 
reach  the  TIP  has  been  left  open  (See  10). 

Note:  Normally  the  character  "@"(atsign)  gets  the  attention  of  the  TIP.  The  TIP  starts 
responding  when  you  hit  "atsign",  and  stops  responding  when  you  hit  carriage  return  or 
linefeed.  "@"  is  called  the  TIP  intercept  character.  "@"  is  inconvenient  for  the 
Lineprocessor.  The  25  in  the  command  to  the  TIP  in  STEP  6  makes  <CTRL-Y>  the  TIP 
intercept  character.  <  CTRL-Y  >  will  remain  your  TIP  intercept  character  until  you  reset  the 
TIP,  or  the  TIP  malfunctions,  or  you  set  the  intercept  to  some  other  character. 

STEP-7  Strike  "  <  CTRL-Y  >  SPACE  L  SPACE  43  CARRIAGERETURN" 

Note:  43  is  the  number  of  host  Office- 1;  you  may  log  into  other  hosts  by  using  other  numbers. 
Only  certain  hosts  run  NLS.  The  TIP  will  respond  with  its  TENEX  login  message. 

STEP-8  When  you’ve  seen  the  TENEX  Login  message,  type  "TER  ESCAPE/ALTMODE  LI 
ESCAPE/ALTMODE  CARRIAGERETURN". 

STEP-9  Login  to  TENEX  and  NLS. 


GLOSSARY 


145 


s 


STEP- 10  When  you  are  finished  with  your  NLS  session,  you  can  disconnect  from  the  TIP  by 
typing  <  CTRL-Y  >  CARRIAGERETURN. 

Note:  If  you  log  out  of  TENEX  at  the  end  of  your  session,  but  do  not  disconnect  from  the  TIP, 
you  can  pick  up  at  STEP  9  next  time  merely  by  typing  <CTRL-C>  . 

Simulate  terminal  type  TYPE  OK:  TYPE  =  Tasker  or  Ti  (terminal)  or 
NVT;  or  Lineprocessor  or  Imlac  or  Execuport;  or  33-TTY  or  35-TTY  or 
37-TTY.  The  command  "Simulate  terminal  type"  makes  your  terminal  mimic 
some  other  type  of  terminal,  preserving  the  state  of  the  current  NLS  session  as 
much  as  possible.  Its  common  use  is  to  move  a  display  user  between  DNLS  and 
TNLS.  Tasker,  Imlac,  and  Lineprocessor-which  cannot  be  simulated  from  a 
teletype-move  the  user  to  DNLS;  all  the  other  types  operate  in  TNLS. 

TNLS  example: 

BASE  C:  Simulate  (terminal  type)  C:  33-TTY  OK: 

BASE  C: 

Site:  Computer:  Each  computer  in  the  ARPA  computer  network  has  a  name 
corresponding  to  its  location  and  called  its  Site. 

Network  Information  Center:  5eeNIC. 

PDP-10:  See  PDP-  1 0 . 

size  limits:  A  file  may  contain  no  more  than  9690  statements  (if  each  statement  is 
little  more  than  a  word  long)  or  370  pages  =  189,440  5-character  words.  A 
statement  may  contain  no  more  than  2000  characters.  Use  the  Show  File  Size 
command  to  see  the  size  of  a  file. 

.SK;  Sort  Key  program:  A  filename  with  this  extension  points  to  a  compiled  L10 
sort-key  extractor.  The  Load  Program  command  in  the  Programs  subsystem  will 
place  the  Sort  Key  in  your  buffer  and  automatically  institute  it  as  your  current 
sort-key  replacing  any  other  sort-key  that  might  be  there.  See  also:  loading. 

sort-key  extractors:  See  sort-keys. 

slash: 

printed  by  the  system  in  prompts  between  your  current  choices:  See  prompts. 

to  divide  in  the  Calculator:  See  divide. 

slash:  /  prints  the  characters  surrounding  you:  Typing  the  key  /  prints  the  characters 

surrounding  you.  You  may  place  the  backslash  among  the  elements  in  an  ADDRESS.  After 
you  terminate  the  ADDRESS,  a  few  characters  with  a  line  feed  break  and  an  arrow  (==  >) 
pointing  to  the  character  you  are  on  will  appear.  In  TNLS  at  the  herald  of  a  subsystem,  the 
characters  surrounding  you  will  print  immediately  when  backslash  is  typed.  COMPARE 
address  slash,  period. 

TNLS  example: 

BASE  C:  / 

1  2  3 

==>4 567 

BASE  C: 

To  change  the  number  of  surrounding  characters  printed:  See  currentcontext 
(USEROPTIONS). 

SNDMSG:  TENEX  sndmsg  subsystem:  a  TENEX  subsystem  that  allows  you  to 
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send  unrecorded  TENEX  sequential  files  or  typed  in  messages  to  other  users  by 
username.  Use  the  SENDMAIL  subsystem  of  NLS  to  send  messages  in  NLS. 
To  use  the  sndmsg  subsystem,  Goto  TENEX,  and  type  "SNDM"  followed  by 
carriage  return.  TENEX  will  prompt  you  from  then  on.  The  message 
user-subsystem  allows  you  to  send  and  receive  TENEX  sndmsgs  in  NLS.  To  read 
>our  messages  in  TENEX,  type  MESSAGE  <CR>. 

sending  messages  from  sndmsg  to  an  NLS  mailbox:  You  may  address  a  TENEX  sndmsg 
to  users  at  NLS  sites  in  such  a  way  that  the  message  automatically  enters  the  NLS  Sendmail 
subsystem  and  thus  avail  yourself  of  addressing  by  ident,  cataloging,  recording  the  message,  etc. 
Simply  type  "your  IDENT/addressee  IDENT(s)@sitename"  where  TENEX  prompts  you  for  a 
username. 

the  SENDMAIL  subsystem:  See  sendmail. 

the  Message  user-subsystem:  See  message  (PROGRAMS). 

the  TENEX  MESSAGE.  TXT  file:  Seemessage. 

sending  an  NLS  file  via  sndmsg:  See  Output  Terminal. 

username:  See  directory. 

network:  See  network. 

Software:  information  contained  in  an  information  storage  device,  or  transferred 
via  a  communication  medium  as  opposed  to  the  hardware  that  makes  up  the 
device,  or  medium.  This  term  is  specifically  used  to  refer  to  computer  machine 
instructions,  or  "code".  Stored  information,  or  data,  is  contained  in  what  is 
called  a  "data  base".  NLS  software  is  oriented  for  use  from  a  Display,  or  from  a 
Teletype.  Users  may  write  their  own  software  called  userprograms.  See  also: 
documentation. 

Dialog  Support  Systems  (DSS):  See  Dialog. 

DNLS:  Display  oNLine  System  SeeDNLS. 

TNLS:  Typewriter  oNLine  System.  5eeTNLS. 

NLS:  See  NLS. 

Sort  STRUCTURE  (at)  DESTINATION  OK:  The  command  "Sort"  puts  the 
highest-level  statements  in  a  plex  or  group  in  order  according  to  your  current 
sort-key.  Statements  carry  their  substructure.  "Sort  statement"  has  no  meaning 
and  specifying  "Branch"  for  this  command  defines  a  plex  (one  level  down)  to  be 
sorted.  After  execution,  you  are  at  the  first  character  of  the  new  group  or  plex. 

TNLS  example: 

BASE  C:  Sort  C:  Plex  A:  4b  1 

BASE  C: 

keys:  sort  keys  and  effects:  See  sort  -keys. 

Sort- Keys  library:  These  are  some  of  the  user-programs  that  modify  the  rules  for 
sorting  by  the  Sort  STRUCTURE  command  in  the  BASE  subsystem.  They  are 
available  with  the  Load  Program  command  in  the  Programs  subsystem.  For 
other  useful  sort-keys,  see  Class-II. 

Limitations  of  the  default  sort:  See  Limitations. 

Sortnmskp.  SK:  See  Sortnmskp. 
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Sortnocase.  SK:  See  Sortnocase. 

Sortnum.  SK:  5ee  Sortnum. 

Sortrev.  SK:  5ee  Sortrev. 

Sortnmskp.  SK:  After  loading  the  sortkey  "sortnmskp",  whenever  you  use  the 
command  'Sort''  it  will  order  statements  in  the  default  order  but  disregarding 
statement  names. 

Sortnocase.  SK:  After  loading  the  sortkey  "sortnocase",  whenever  you  use  the 
command  "Sort"  it  will  order  statements  disregarding  capitalizations. 

Sortnum.  SK:  After  loading  the  sortkey  "sortnum",  whenever  you  use  the 
command  "Sort"  it  will  order  statements  according  to  the  first  number  anywhere 
in  each  statement.  The  number  may  include  a  decimal  and  may  be  immediately 
preceded  by  a  minus  sign.  All  statements  without  numbers  will  be  put  at  the  end 
in  their  original  order. 

Sortrev.  SK:  After  loading  the  sortkey  "sortrev",  whenever  you  use  the 
command  "Sort"  it  will  order  statements  in  reverse  the  default  order. 

Source  — code:  The  characters  making  up  the  human-readable  program. 

Source:  one  of  the  following: 

SOURCE  in  command  syntax:  a  variable  in  the  command  notation  that  tells  you  to  indicate 
some  text  (sometimes  files)  to  operate  on.  It’s  mainly  meant  for  text  already  online,  but  you 
can  also  type  in  new  text.  In  TNLS,  SOURCE  wants  either  an  ADDRESS  or  an  optional 
TYPEIN  of  text  (prompted  by  A/[T]:).  In  DNLS  you  can  also  BUG  (prompted  by 
T/B/[A]:).  When  pointing  (with  BUG  or  ADDRESS)  to  Group  or  Text,  two  BUGs  or  two 
ADDRESSes  are  needed.  See  also:  variable,  notation. 

ADDRESS:  See  address . 

OPTIONAL  TYPEIN  [  T  ]  :  preceed  the  TYPEIN  with  <CTRL-U>  Seetypein, 

In  DNLS,  you  can  also  BUG  the  CONTENT  (prompted  by  A/B/[T]:  ).  See  bug. 

source  in  file  structure:  Every  statement  (except  the  origin)  is  defined  by  a  statement  one 
higher  which  is  called  its  source.  The  source  is  always  one  level  higher  than  the  node  referred 
to  as  the  substatement.  In  the  illustration,  the  source  of  statement  lb2  is  lb;  the  source  of  lb 
is  statement  1.  See  also:  illustration. 

sources  for  Sendmail  items:  See  item  (SENDMAIL). 

SP  — colon:  SP:  SPACE:  In  a  few  commands  NLS  requires  a  space  to  continue  and 
prompts  SP:  .  You  need  to  strike  the  space  bar. 

<SP>:  space  key  ...  also  represented  as  <  >  :  The  notation  <SP>  or  <  >  represents 
the  space  bar  on  the  keyboard  (or  all  five  keys  depressed  on  the  keyset.  See  also: 
keyset).  In  Terse  recognition  mode,  <  >  represents  space.  See  also:  notation. 

Square-brackets  in  content-analyzer  patterns:  In  writing  content  analyzer 
patterns,  square  brackets  instruct  the  search  to  pass  a  statement  if  the  pattern 
enclosed  is  anywhere  to  be  found  in  the  statement.  If  you  omit  square  brackets, 
the  search  will  begin  only  at  the  first  character  and  give  up  at  the  first  character 
that  fails  to  pass.  You  use  the  Programs  subsystem  to  write  content  analyzer 
programs.  See  also:  writing  (PROGRAMS) . 
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SRI:  acronym  for  Stanford  Research  Institute:  333  Ravenswood  Avenue 

Menlo  Park  California,  94025 

(415)  326-6200  and  ask  for  ARC. 

SSEL:  Source  SELection:  See  source. 

Stack:  Subsystem  Stack:  an  ordered  list  of  the  NLS  subsystems  you’ve  employed. 
Those  you  reached  via  the  Execute  command  are  erased  from  the  stack  after  the 
command  is  finished.  When  you  Quit  back  to  an  earlier  item  in  the  stack,  the 
intervening  ones  are  erased.  To  view  your  subsystem  stack  anytime  in  NLS,  type 
the  left  anglebracket  ( < )  at  the  herald.  To  display  the  name  of  your  current 
subsystem  in  NLS,  type  the  right  anglebracket  (>)  at  the  herald. 

Seeing  your  current  subsystem  >:  See  greaterthan. 

Seeing  your  subsystem  stack  <:  Seelessthan. 

Stacks:  Program  stack:  A  stack  is  used  to  hold  your  programs  by  name  in 
sequential  order  as  you  compile  or  load  them.  You  can  point  to  them  by  number 
or  name  to  run  them.  The  delete  last  command  will  delete  the  top  or  most 
recent  program  on  your  stack. 

Running:  See  running. 

The  Programs’  Delete  Last  command:  See  Delete  Last  (PROGRAMS). 

Star: 

to  find  the  next  name  in  an  ADDRESS:  See*  nextname. 

Star  convention  in  filenames:  When  you  want  to  specify  more  than  one  file  in  a  command,  a 
star  may  replace  any  field  of  a  filename.  For  example,  to  get  all  the  versions  of  a  file,  type: 
directory,  filename.extension;  *  Modification  files  have  the  extension  ".PC;  ".  When  you  use 
in  a  command  it  does  not  touch  files  with  the  extension  ".PC;  "  unless  it  affects  the 
permanent  file  that  bears  the  modifications. 

the  calculator  star  (multiply)  command:  See  multiply. 

stars-in-brackets:  [**]:  See  stars  in  prompts. 

Stars  in  prompts:  **  prompt  for  Special  alternatives  and  FILTER:  Steps  in  certain  NLS 
commands  allow  a  list  of  options  that  are  not  used  frequenty.  When  full  prompting  is  on  and 
the  list  is  too  long  to  print  easily,  "[**]"  represents  the  list.  You  may  see  the  list  by  typing 
<CTRL-U>  questionmark  (?)  in  NLS.  See:  FILTER,  options,  verb,  square-bracket. 

Making  prompting  on,  off  and  partial:  See  prompt  (USEROPTIONS). 

Start  Record  (of  session  to  file)  CONTENT  OK:  The  command  "Start 
Record”  allows  you  to  begin  to  record  on  a  file  all  the  interactions  with  NLS  on 
another  file.  CONTENT  wants  you  to  TYPEIN  or  point  to  a  FILEADDRESS 
of  the  file  on  which  you  want  to  record  all  the  things  you  do.  To  terminate  the 
recording,  use  the  command  Stop  Record  of  session.  Then  you  can  see  a 
simulation  of  exactly  what  you  did  by  using  the  command  Playback. 

Playback  Record  command:  See  Playback. 

Stop  Record  command:  See  Stop. 

Startup  (commands  branch  address)  CONTENT  OK:  The  Useroptions 
subsystem  command  "Startup"  allows  you  to  specify  certain  commands  to  take 
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place  automatically  every  time  you  enter  NLS.  CONTENT  wants  you  to  give  the 
ADDRESS  of  a  statement  or  branch  of  commands  that  can  be  executed. 
Thereafter,  whenever  you  enter  NLS,  the  commands  in  the  branch  at  that  address 
will  be  executed  as  in  the  Process  STRUCTURE  command.  <CTRL-0>  halts 
processing. 

For  automatic  user-program  or  user-subsystem  loading.  See  include  (USFROPTIONS) . 

Effects:  Because  the  process  which  carries  out  commands  skips  over  the  name  of  a 

statement,  many  users  begin  this  branch  with  a  statement  consisting  only  of  a  name  and 
place  the  actual  commands  in  structure  under  the  name.  Remember,  in  building  such  a 
branch,  statements  derive  their  name  delimiters  from  their  SOURCE.  If  the  delimiters  of 
the  SOURCE  are  NULL  NULL,  then  the  process  will  skip  over  the  first  word  of  your 
command.  You  can  use  the  command  Set  Name  (delimiters  .n)  to  change  the  name 
delimiters  for  your  startup  branch. 

Statement:  the  basic  NLS  file  STRUCTURE  component  made  of  STRINGS  of 
from  1  to  2000  characters.  It  may  be  a  character,  line,  sentence,  heading, 
paragraph,  table,  or  graphic.  You  point  to  a  statement  by  pointing  to  any 
character  within  it.  See  also:  Insert  Statement,  INFILEADDRESS, 

STRINGPOSITION . 

STRING:  See  STRING. 

structural  relationships:  See  structural. 

signatures:  statement  signatures:  See  Capital-K . 

Statement  (at)  CONTENT  OK:  The  Sendmail  subsystem  command 

"Statement1'  allows  you  to  send  an  NLS  statement.  Specify  the  statement  to  be 
mailed  as  a  SOURCE.  VIEWSPECS  do  not  matter. 

Statement:  See  branch. 

SOURCE:  See  statement. 

viewspecs:  See  viewspecs. 

statement-return  ring:  See  return. 

STATEMENTNAME:  statementname  (no  preceding  character):  a  string  of 

characters  that  begins  with  an  alphabetic  letter,  is  enclosed  in  name  delimiters, 
and  precedes  all  other  printing  characters  of  the  statement  it  names.  It  may 
include  letters  of  the  alphabet,  numbers,  hyphen  -,  the  atsign  @,  and  apostrophe  \ 
Case  of  letters  is  ignored.  Statementnames  "name"  a  statement  so  you  can  point 
to  it  by  typing  its  name  in  an  ADDRESS.  One  statementname  can  be  assigned  to 
each  statement.  Using  this  in  an  ADDRESS  works  like  the  Jump  (to)  Name  Any 
command. 

name-delimiters:  See  name-delimiters. 

searching:  See  searching. 

STATEMENTNUMBER:  1A2B3C4D5E...  (no  preceding  character):  a  number 
assigned  to  a  statement,  which  indicates  the  exact  position  of  the  statement  within 
the  structure  of  a  file.  The  number  does  not  remain  a  permanent  part  of  the 
statement,  and  will  change  if  you  change  the  position  of  the  statement.  It  is  a 
series  of  fields  containing  alternately  letters  and  digits.  The  first  field  always 
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contains  a  number.  The  total  number  of  fields  indicates  the  level  of  the  statement; 
the  numbers  and  letters  indicate  consecutive  statements.  See  also:  illustration. 

Status:  The  Show  File  Status  command:  prints  a  list  of  information  about  the  file. 
The  Verify  File  command  checks  to  see  if  the  file  is  bad.  See  also:  Show. 

Show  File  Status  command:  See  Show  File  Status  (BASE). 

verifying  files:  See  verify. 

steps  in  using  a  content-analyzer:  Use  the  BASE  subsystem  command  "Set 
Content"  to  typein  a  pattern; 

or  the  Programs  subsystem  command  "Compile  File"  to  compile  a  program  or 
the  Programs  subsystem  command  "Load  Program"  to  load  a  compiled  program 
with  the  extension  .CA. 

Use  the  BASE  subsystem  command  "Set  Viewspecs"  and  type  in  i  to  turn  the 
content-analyzer  on,  and  j  to  turn  it  off.  In  DNLS,  follow  i  or  j  with  f  to  recreate 
the  window. 

Stop  Record  (of  session)  OK:  The  command  "Stop  Record"  stops  recording 
your  NLS  session  on  the  file  you  had  designated  to  record  your  interactions.  At 
that  point,  the  file  will  be  closed  and  no  more  commands  will  be  recorded. 

TNLS  example: 

BASE  C:  Stop  C:  Record  (of  session)  OK: 

BASE  C: 

Start  Record  of  session  command:  See  start. 

Playback  Record  of  session  command:  See  playback. 

Storage:  See  directory. 

STRING:  one  or  more  consecutive  characters  making  up  a  single  statement.  When 
STRING  is  used  in  command  syntax  notation,  it  means  one  of  the  following 
commandwords  prompted  by  "C:".  See  also:  file,  STRUCTURE, 

INFILEADDRESS,  STRINGPOSITION . 

Character:  See  Character. 

Number:  See  Number. 

Word:  See  Word. 

Visible:  See  Visible. 

Invisible:  See  Invisible. 

Text:  See  Text. 

Link:  See  Link. 

STRINGPOSITION:  within  one  statement  (preceded  by  plus  or  minus):  Letters 
PRECEDED  IMMEDIATELY  BY  A  PLUS  (  +  )  mean  SKIP  FORWARD,  BY 
A  MINUS  (-)  mean  SKIP  BACKWARD.  A  number  between  the  plus  or  minus 
and  the  letter  indicates  the  number  of  skips.  These  elements  will  only  operate 
within  the  statement  where  you  are. 

c  skip  character:  See  character. 

e  skip  to  end  (last  character)  of  statement:  See  statement . 
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f  skip  to  front  (first  character)  of  statement:  See  statement, 
i  skip  invisible:  See  invisible. 

I  skip  link:  See  link, 

n  skip  number:  See  number, 
v  skip  visible:  See  visible, 
w  skip  word:  Seeword. 

Structural  relationships  within  files:  We  refer  to  statements  according  to  how 
they  stand  in  relation  to  other  statements  in  the  file.  The  definitions  of 
relationships  found  below  often  refer  to  an  illustration  available  in  Help.  See  ulso: 
illustration,  STRUCTURE. 

level:  See  level. 

origin:  statement— Statement  zero  See  origin. 

source:  See  source. 

substatement:  See  substatement. 

successor:  See  successor. 

predecessor:  See  predecessor. 

head:  See  head. 

tail:  See  tail. 

end:  See  end. 

up:  See  up . 

down:  See  down. 

next:  See  next. 

back:  See  back. 

return:  See  return. 

STRUCTURE:  the  organization  of  an  NLS  file.  When  STRUCTURE  is  used  in 
command  syntax  notation,  it  means  one  of  the  following  commandwords.  See 
also:  structural,  file. 

Statement:  See  Statement. 

Branch:  See  Branch. 

Group:  See  Group. 

Plex:  SeePlex. 

Subcollections  CONTENT  OK:  The  Sendmail  subsystem  command 

"Subcollections"  enables  you  to  change  the  default  subcollection  assignment  for 
cataloging  of  your  item.  CONTENT  wants  IDENTS  which  are  groups  of  idents. 
If  the  item  has  an  RFC  number,  it  will  automatically  appear  in  the  NIC  and 
NWG  subcollections.  In  general  NIC  numbers  come  from  people  outside  ARC. 
See  also:  Numbering. 

GROUP-IDENT:  See  group- ident. 

CONTENT:  See  content. 
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NIC:  See  NIC. 

NWG:  Acronym  for  Network  Working  Group. 

Subnet:  The  array  of  IMPs,  TIPs  and  communication  circuits  which  deliver 

messages  from  one  host  to  another. 

Substatement:  a  statement  that  is  one  level  lower  than  the  one  you  are  referring 
to.  In  the  illustration,  statements  1,  2,  and  3  are  each  a  substatement  of  the 
origin  statement  (0).  Statements  la  and  lb  are  the  substatements  of  statement  1. 
Statement  3c la  is  the  only  substatement  of  3c  1  shown.  Substatements  are  always 
one  level  lower  than  the  one  referred  to  as  the  source.  Statements  (such  as 
statement  2)  do  not  always  have  substatements.  See  also:  illustration. 

Substitute  STRING  (in)  [(Filtered:)  FILTER]  STRUCTURE  (at) 
DESTINATION  (new  STRING)  CONTENT  (old  STRING)  CONTENT 
(Finished?)  S/Y/N  OK: 

The  command  "Substitute"  allows  you  to  put  a  new  STRING  in  the  place  of  an 
old  STRING  everywhere  it  appears  in  the  STRUCTURE  you  specify.  This  is  the 
most  common  editing  command  in  TNLS. 

TNLS  example: 

BASE  C:  Substitute  C:  Visible  (in)  C:  Branch  (at)  A:  0 

(New  VISIBLE)  T:  $1000.50 

(Old  visible)  T:  $1.50 

Finished?  Y/N/S:  Yes  OK: 

Substitute  In  Progress 

Substitutions  made:  8 

BASE  C: 

Effects  S/Y/N:  Substitute  is  easier  than  Replace  when  you  want  to  make  the  same  replacement 
in  more  than  one  location.  TYPEIN  the  new  and  old  text  for  CONTENT.  If  you’re  in  TNLS 
and  want  to  substitute  nothing  for  the  old  STRING,  just  give  a  Command  Accept  for 
CONTENT.  In  DNLS  use  <CTRL-N>.  S/Y/N  gives  you  the  choice  of  seeing  your  current 
substitution  list  status  or  cycling  through  the  command  again  (you  are  back  at  "new")  and 
making  another  substitution  in  that  STRUCTURE.  You  are  limited  to  30  substitutions  with  a 
maximum  of  600  total  characters  typed  in  by  you. 

FILTER  option:  enter  VIEWSPECS:  See  filter. 

STRING:  character,  word,  text,  visible,  invisible,  number,  link:  See  STRING. 

STRUCTURE:  statement,  branch,  group,  plex:  See  STRUCTURE. 

.SUBSYS;  An  L10  program  written  to  support  a  CML  program:  A 

filename  with  this  extension  points  to  a  compiled  L10  program.  The  Load 
Program  command  will  place  the  L10  program  in  your  buffer  and  then  search  for 
a  file  with  the  same  name  but  with  extension  .CML;.  When  it  finds  such  a  file,  it 
will  automatically  load  that  program  as  well  and  automatically  attach  it  as  a 
subsystem  if  it  is  formatted  for  that.  See  also:  CML,  filename,  loading,  L10, 
buffer,  programs. 

SUBSYSTEM:  a  subordinate  system  that  with  others  makes  up  a  whole  system. 
The  subsystems  that  divide  the  commands  in  the  Online  System  (NLS)  are  listed 
below.  When  the  variable  SUBSYSTEM  is  found  in  a  command  syntax 
expression,  it  stands  for  one  of  these  (or  an  attached  usersubsystem)  as  a 
commandword.  By  default,  you  are  in  the  BASE  subsystem  when  you  enter  NLS. 
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In  TNLS,  heralds  tell  you  your  current  SUBSYSTEM.  In  DNLS  the  name  of 
your  current  SUBSYSTEM  is  in  an  upper  corner  of  your  screen.  See  also: 
systems,  user-subsystems. 

Base:  5eebase. 

Calculator:  See  calculator. 

Programs:  See  programs. 

Sendmail:  Seesendmail. 

TENEX  Timesharing  System:  See  TENEX. 

Useroptions:  See  useroptions. 

User-subsystems:  See  usersubsystems. 

Attaching  subsystems:  See  attach. 

Stack:  Subsystem  Stack  See  Stack. 

Heralds:  See  heralds. 

Subtract  CONTENT  OK:  The  Calculator  subsystem  command  "Subtract" 
subtracts  the  value  of  the  accumulator  by  the  number  you  specify  for  CONTENT. 
See  also:  operators,  accumulator,  CONTENT,  OK. 

successor:  the  statement  following  a  given  statement  at  the  same  level  and  having 
the  same  source.  In  the  illustration,  the  successor  of  3a  is  3b;  lb3  is  the  successor 
of  lb2  (which  is  called  the  predecessor).  Statements  either  have  one  successor  or 
none  (such  as  lb).  The  origin  statement  NEVER  has  a  successor.  See  also: 
illustration . 

suggestions  (about  NLS):  See  reporting. 

Supervisor:  See  universal. 

Superwatch:  a  group  of  programs  that  measures  the  loads  on  different  pieces  of 
hardware  and  on  subsystems  of  TENEX  and  NLS. 

Syntax  (of  command)  COMMANDVERB  OK:  The  command  "Syntax"  is 
available  in  all  subsystems.  Use  it  to  see  a  short  description  of  the 
COMMANDVERB  you  specify.  See  notation. 

Systems:  entering  and  leaving:  To  login  to  NLS  online,  you  need  to  first  call  a 
timesharing  system,  TENEX.  Then  you  call  NLS  from  TENEX.  When  you 
enter  NLS,  you  begin  in  the  BASE  subsystem.  A  number  of  other  SUBSYSTEMS 
are  available.  To  leave  NLS  or  any  other  SUBSYSTEM,  use  the  Quit  command. 
To  goto  another  NLS  SUBSYSTEM,  use  the  Goto  SUBSYSTEM  command.  See 
also:  SUBSYSTEM. 

login  to  TENEX:  See  login. 

NLS:  See  entering- NLS. 

reaching  subsystems.-  See  reaching. 

reporting  bugs  and  making  suggestions:  See  reporting. 

Hardware:  See  Hardware. 

Software:  5ee  Software. 

Documentation:  See  Documentation. 
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commands  in  most  NLS  subsystems:  See  universal. 

systems-commands:  See  universal. 

Process  (commands  from)  STRUCTURE  OK:  See  Process. 

Logout  OK:  See  Logout. 

terminal  commands:  See  terminal-commands. 


GLOSSARY 


155 


T 


t  ViewspeC:  show  first  lines  only:  "Show  only  one  line  of  each  statement." 
Normally,  all  lines  of  each  statement  appear  (standard  viewspecs  w  and  s);  t 
changes  your  view  to  one  line.  Unlike  x,  it  does  not  affect  the  number  of  levels 
shown.  Example:  view  only  3  lines  by  using  the  string  trr.  Viewspec  t  changes 
viewspecs  w,  s,  r,  and  q. 

T-COlon:  T:  TYPEIN:  5ectypein. 

TAB: 

The  tab  command:  See  tab -command. 

TAB  — command:  Typing  the  TAB  character  at  the  herald  in  the  BASE  subsystem 
moves  you  to  the  next  occurrence  (from  your  present  location)  of  the  last 
character,  word,  or  content  search  you  specified  as  an  ADDRESS  element.  See 
also:  TAB,  k. 

TNLS  example: 

BASE  C:  .n 

BASE  C:  .n"elephant"=c 

BASE  C:  Print  CA:/C: 

My  elephant  eats  granola. 

BASE  C: 

Effects:  If  you  have  not  previously  used  a  content  search,  you  will  get  the  message  "<tab>  valid 
only  to  repeat  a  previous  search".  On  most  terminals,  the  character  for  the  function  TAB  is 
<  CTRL-I  >  (which  you  can  augment  with  Useroptions’  Control  command).  No  OK  is  required 
for  the  execution  of  this  command.  See  also:  Control  (USEROPTIONS). 

character  search  in  an  ADDRESS:  See  characteraddress. 

word  or  content  search  in  an  ADDRESS:  See  contentaddress. 

Jump  (to)  Word  command:  See  Jump  Word. 

Jump  (to)  Content  command:  See  Jump  Content. 

Tabbing  in  text:  5ee<TAB>. 

<TAB  >:  Typing  a  TAB  during  TYPEIN  creates  an  invisible  in  the  file,  which 
causes  the  text  to  skip  to  the  next  tabstop  on  the  line  and  resume  printing  there. 
<  CTRL-I  >  creates  a  TAB;  you  can  define  an  additional  character  for  TAB  with 
the  Useroptions’  Control  characters  command.  The  default  tabstops  are  columns 
8,16,24,32,40,48,56,64,72,80,88,96,104.  Changing  the  tabstops  is  done  with  the 
Useroptions  subsystems  Printoptions  Tab  command.  If  you  change  tabstops  while 
working  on  one  file,  they  will  also  be  changed  for  all  other  files  you  load.  They 
will  not,  however,  be  changed  for  other  users  who  may  be  working  in  the  same 
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files  as  you.  When  a  character  for  TAB  is  typed  at  the  herald  in  BASE 
subsystem,  it  is  a  command  with  a  different  special  function. 

Useroptions'  Control  characters  command:  See  control  (USEROPTIONS). 

Useroptions’  Printoptions  Tab  stop  settings  command:  See  printoptions  tab 

(USEROPTIONS). 

User  Programs:  See  programs. 

The  TAB  command  in  BASE  subsystem:  See  tab-command. 

Setting  tabstops:  See  printoptions  tab  (USEROPTIONS). 

Table:  data  displayed  in  graphs  or  columns  and  rows. 

tail:  the  last  statement  at  the  same  level  having  the  same  source  as  a  given 

statement.  In  the  illustration,  the  tail  of  3a  is  3c;  the  tail  of  3c  1  is  3c  1  itself.  The 
origin  statement  has  no  tail.  See  also:  plex,  illustration. 

TELNET:  In  the  ARPA  Computer  network,  the  software  that  allows  a  user  at  one 
site  access  to  a  timesharing  system  at  another  site.  User  Telnet  is  the  software  at 
the  user’s  site;  Server  Telnet  is  the  software  at  the  remote  site. 

temporary  modification:  You  can  set  the  modification  mode  to  allow 
modifications  that  are  not  permanent  with  the  Set  Temporary  modifications 
command.  This  device  is  sometimes  called  Browse  Mode.  After  making 
modifications  while  in  this  mode,  you  are  given  a  chance  to  keep  them.  Use  the 
Reset  Temporary  modifications  command  if  you  do  not  wish  to  keep  the 
modifications;  the  modification  file  in  which  they  are  located  will  be  deleted,  and 
the  modification  mode  is  set  back  to  normal  for  the  given  file.  See  also: 

modification. 

Set  Temporary  (modifications)  command:  5eeSet  Temporary. 

Reset  Temporary  (modifications)  command:  See  Reset  Temporary. 

TENEX  Timesharing  System:  the  timesharing  system  that  supports  NLS  on  the 
PDP-10.  NLS  runs  as  a  subsystem  of  TENEX  (which  is  called  the  "superior 
Executive"  at  this  top  level)  and  draws  extensively  on  TENEX’s  file  handling.  In 
turn,  TENEX  is  available  as  a  subsystem  of  NLS  via  the  Goto  TENEX 
command.  Execute  TENEX  doesn’t  work. 

leaving  NLS  to  TENEX:  To  return  to  the  TENEX  timesharing  system  from  NLS  use  the  Quit 
NLS  command.  After  that,  you  can  type  "con"  followed  by  carriage  return  at  the  TENEX 
herald  to  return  to  NLS.  To  break  contact  with  TENEX  entirely  use  the  Logout  command  in 
TENEX  or  NLS.  To  leave  NLS  anytime  for  an  excursion  in  TENEX,  use  the  Goto  TENEX 
command.  This  command  issues  to  you  a  second  copy  of  TENEX  called  "inferior  exec".  To 
return  from  this  second  copy  to  NLS,  use  the  TENEX  Quit  command. 

login:  See  login. 

questionmark  command:  See  questionmark. 

recognition-TENEX:  (recognition  of  commands  in  TENEX):  Commands  in  TENEX,  either  the 
Executive  or  a  subsystem  of  NLS,  are  recognized  in  the  Demand  mode.  See  demand. 

files:  See  files. 

filenames  in  TENEX:  See  filenames. 

SNDMSG:  Sersndmsg. 


GLOSSARY 


157 


T 


TENEX  as  a  subsystem  of  NLS:  See  inferior. 

TENEX-herald:  the  at  the  margin.  It  shows  that  you  are  talking  to  the 
timesharing  system  that  supports  NLS  and  TENEX  is  ready  to  accept  commands. 

terminal -commands: 

Accept  Connect  (from  terminal  number)  (for)  CONTENT  OK:  See  Accept. 

Disconnect  Terminal  OK:  See  Disconnect. 

Simulate  terminal  type  TYPE  OK:  See  Simulate. 

semicolon:  See  semicolon. 

Connect  to  TTY:  See  Connect  TTY. 

Connect  to  Display:  See  Connect  Display. 

Clear  TTY  simulation  window:  See  Clear. 

Terminals:  Devices  more  or  less  like  typewriter  keyboards  with  either  paper  or 
screens  which  people  use  to  typein  and  read  output  from  computers.  See:  DNLS, 
TNLS. 

connecting  terminals:  [linking]  See  connecting. 

Tip  Settings:  See  settings. 

terminal  commands:  See  terminal-commands. 

Terse:  a  recognition  mode  that  recognizes  one  commandword  for  each  single 

character.  To  recognize  other  commands  beginning  with  the  same  character,  you 
must  first  type  a  space  (represented  by  <  >  in  the  list  of  commands  in 
questionmark)  and  then  these  commands  will  become  available  in  a  secondary 
mode.  See  also:  commandword.  Four  secondary  recognition  modes  are 
available  in  Terse  after  the  space.  These  secondary  modes  work  like  they  do 
when  they  are  primary  modes. 

Terse:  See  Terse. 

Anticipatory:  See  anticipatory. 

Demand:  Sec  demand. 

Fixed:  See  fixed. 

Terse:  Terse  Secondary  mode  works  like  Anticipatory  except  it  contains  only  those 
words  that  are  not  recognized  with  one  character  before  you  type  the  space.  With 
the  rest  of  the  secondary  modes,  after  you  type  the  space  you  have  the  choice  of 
all  words  beginning  with  that  letter.  See  also:  ANTICIPATORY. 

Text:  any  continuous  STRING  of  characters  within  a  STATEMENT.  To  point  to 
Text,  you  must  point  to  both  the  beginning  and  the  end  characters. 

pointing:  See  pointing. 

TIP:  Terminal  IMP:  An  IMP  which  is  augmented  by  additional  memory  and  a 
multiline  controller.  The  TIP  contains  a  network  control  program  and  a 
TELNET  program  within  it  to  permit  terminals  to  reach  the  network  directly 
through  it.  See  also:  IMP. 
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settings:  See  settings. 

Title  CONTENT  OK:  The  SendmaL  subsystem  command  "Title"  allows  you  to 
enter  a  title  which  will  be  used  in  journal  citations,  hardcopy  printouts  of  the 
document,  catalog  listings  and  indexes  including  the  title-word  index. 

document:  See  document. 

hardcopy:  See  hardcopy. 

indexes:  See  indexes. 

word:  title-word  indexes:  See  catalogs. 

title-word:  See  catalogs. 

TNLS:  Typewriter  oNLine  System.  See  also:  DNLS. 
oNLine  system:  See  NLS. 
simulation:  TNLS  simulation:  See  simulate. 

To  — get  — DNLS:  If  you  have  told  TENEX  you  are  using  an  Imlac  or  Lineprocessor 
by  the  Terminal  type  command  after  logging  into  TENEX,  to  get  into  NLS  type 
NLS  after  the  TENEX  herald.  See  also:  login,  entering-NLS. 

TENEX's  Terminal  type  command:  See  terminal -type, 

TODAS:  Acronym  for  Typewriter  Oriented  Documentation  Aid  System.  The 

version  of  NLS  used  from  typewriter-like  terminals  prior  to  1971.  See  also: 

TNLS. 

Total  OK:  The  Calculator  subsystem  command  "Total"  copies  current 

accumulator  value  to  the  end  of  the  Calculator  file.  The  formatted  value  will  be 
typed.  See  also:  file,  accumulator. 

Transpose:  The  command  "Transpose"  allows  you  to  make  NLS  entities  change 
places. 

STRING:  Transpose  STRING  (at)  DESTINATION  (and)  DESTINATION  OK:  This  group  of 
"Transpose"  commands  makes  two  STRINGS  of  the  same  kind  replace  each  other. 

TNLS  example: 

BASE  C:  Transpose  C:  Word  (at)  A:  1 

and  A:  1  +e 

OK. 

BASE  C: 

Effects:  After  execution,  you  are  at  the  first  character  of  the  STRING  you  selected  first. 
STRING:  Character,  Text,  Word,  Visible,  Invisible,  Number,  or  Link:  See  string. 

STRUCTURE:  Transpose  STRUCTURE  (at)  DESTINATION  (and)  DESTINATION 

[FILTER]  OK 

This  group  of  "Transpose"  commands  makes  two  STRUCTURES  of  the  same  kind  replace  each 
other. 

TNLS  example: 

BASE  C:  Transpose  C:  Statement  (at)  A:  la 

and  A:  1 

OK: 

BASE  C: 
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Effects:  After  execution,  you  are  at  the  first  character  of  the  STRUCTURE  you  selected 
first. 

FILTER  Option:  enter  VIEWSPECS:  This  option  transposes  only  statements  that  "pass" 
certain  viewspecs  you  can  specify  as  a  string  of  character  codes.  Type  the  OPTION 
character  first  and  then  enter  any  combination  of  the  following  viewspecs:  for  level-a,  b, 
c,  d,  e,  w,  x;  for  content  analyzer-i,  j,  k;  for  sequence  generator-O,  P.  If  the  filtering 
leaves  statements  somewhere  without  a  source,  substatements  will  move  up  in  level. 

STRUCTURE:  Statement,  Branch,  Plex,  or  Group:  See  structure. 

Trick:  When  NLS  is  searching  for  the  boundaries  of  a  word,  visible,  or  invisible, 
etc.,  the  character  you  actually  address  or  bug  is  ignored.  For  example,  if  you 
point  to  the  space  between  two  words,  both  words  wll  be  effected  by  your 
command. 

Trim  Directory  (no.  versions  to  keep)  CONTENT  OK  (really?)  OK:  The 
command  "Trim  Directory"  will  delete  any  extra  versions  of  each  file  so  that 
there  are  no  more  than  the  given  number  of  versions.  If  you  have  write  access  to 
the  directory  (either  by  definition  or  having  connected  to  it),  you  don’t  need  to 
type  the  password.  If  you  don't  specify  a  directory,  it  will  trim  the  directory  to 
which  you  are  connected;  the  password  won’t  be  necessary. 

TNLS  example: 

BASE  C:  Trim  C:  Directory  (no.  versions  to  keep)  T:  1 

(really?)  OK: 

Trimmed  Files  are: 

(  DOE,  WONDER. NLS,  )  2  files  deleted 

BASE  C: 

versions:  See  versions. 

TTY  — simulation  window:  The  TTY-simulation  window  normally  occupies  2  lines 
at  the  very  top  of  your  DNLS  screen.  It  shows  the  last  two  lines  of  what  you 
would  see  if  you  went  into  TENEX  via  Goto,  Execute,  or  <CTRL-C>.  If  you 
want  to  see  more  than  these  two  lines,  do  one  of  the  above,  or  move  the  window 
to  one  of  your  larger  file  display  windows.  Some  kinds  of  information  that  will 
appear  in  this  window  are:  general  status  info  (like  the  name  of  a  file  loaded  or 
updated),  TENEX  status  response  to  <  CTRL-T  > ,  errormessages,  system 
messages,  notification  of  connected  terminals,  semicolon  (comment)  commands, 
response  to  slash  and  backslash  in  ADDRESSES.  If  you  were  in  TNLS,  you 
would  see  all  this  included  among  your  NLS  feedback  and  printing. 

to  make  the  TTY  window  blank  again:  use  the  Clear  (TTY  Window)  command. 

moving  your  TTY  window  to  a  file  display  window:  use  the  Set  TTY  (simulation  for 
window)  command. 

to  move  your  TTY  window  back  to  top  Of  screen:  use  the  Reset  TTY  (window)  command. 

Connected  terminals  for  DNLS  users:  See  connected . 

TTY:  See  terminals. 

window:  See  display. 

.TXT;  represents:  a  sequential  file  unloadable  in  NLS.  See  sequential . 

TYPEIN:  any  string  of  characters  from  the  keyboard,  terminated  by  an  OK. 
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FILEADDRESS,  or  an  Ident,  it  prompts  you  with  T. 
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U  ViewspeC:  recreate  display  after  each  change:  "Re-create  display  screen 
whenever  the  user’s  location  or  contents  on  the  screen  change."  Viewspec  u 
always  displays  on  your  screen  the  current  view  of  your  current  location.  The 
display  is  automatically  re-created  after  an  editing  operation  or  changing  views, 
etc.  Viewspec  u  turns  off  viewspec  v,  but  does  not  affect  any  other  viewspec. 
This  is  a  default  viewspec.  See  also:  DNLS,  viewing,  re-creating,  f,  v. 

<UKC>:  UnKnown  Character:  could  be  an  underline,  or  overline,  or  just  about 
any  very  special  character  not  in  the  ASCII  standard  72  character  set.  See  also: 
sort,  loading  (PROGRAMS). 

Undelete:  to  bring  back  one  of  the  following  that  has  been  deleted  but  not 

expunged. 

File:  Undelete  File  CONTENT  OK:  The  command  "Undelete  File"  returns  to  normal  use  the 
File  you  specify  for  CONTENT  that  has  been  deleted. 

TNLS  example: 

BASE  C:  Undelete  C:  File  T:  neargone.NLS;4 
Undeleted  Files  are: 

(  YOU,  NEARGONE.NLS;4,) 

BASE  C: 

Effects:  Once  a  file  has  been  deleted  it  will  be  erased  permanently  from  the  system  if  you 
use  the  Expunge  command,  if  the  operator  runs  a  program  to  expunge  deleted  files,  or  if 
you  log  out.  You  may  restore  the  file  from  the  deleted  file  list  back  to  normal  status  at 
any  time  before  it  is  expunged.  See  also:  Show  Directory,  undeleted  (BASE). 

Expunge  Directory  command:  See  Expunge  Directory. 

Delete  File  command:  See  Delete  File. 

Filename:  See  fileaddress. 

Show  Directory:  5eeShow  Directory: 

Modifications:  Undelete  Modifications  (to  file)  OK:  Modifications  (made  with  editing 

commands,  programs...)  to  a  file  are  kept  separate  until  merged  into  the  file  with  an  Update. 
All  modifications  since  the  last  Update  can  be  thrown  away  with  the  Delete  Modifications 
command.  Deleted  modifications  can,  until  you  begin  making  new  modifications,  be  restored 
with  the  Restore  Modifications  command. 

TNLS  example: 

BASE  C:  Undelete  C:  Modifications  to  file  OK: 

BASE  C: 

modifications  files:  See  modifications: 

Delete  Modifications  command:  See  Delete  Modifications. 
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Update  File  command:  See  Update, 
unexpanded:  See  restricted. 

Universal  (supervisor)  subsystem:  contains  commands  available  in  all 

subsystems. 

Execute  (command  in)  SUBSYSTEM:  See  Execute. 

Goto  (subsystem)  SUBSYSTEM  OK:  5eeGoto. 

Help  TYPEIN/OK:  5eeHelp. 

Jump:  See  Jump. 

Quit  OK:  See  Quit. 

<CTRL-Q>:  See  <CTRL-Q>. 

Questionmark:  (?)  See  Questionmark. 

Syntax  (of  command)  COMMANDVERB  OK:  The  command  "Syntax"  is  available  in  all 
subsystems.  Use  it  to  see  a  short  description  of  the  COMMANDVERB  you  specify.  See 
notation. 

semicolon:  ;  TYPEIN  OK  See  semicolon, 
lessthan  symbol:  <  Subsystem  Stack.  Seelessthan. 
greaterthan  symbol:  >  current  subsystem.  See  greaterthan . 

OKREPEAT  <CTRL-B>:  See  OKREPEAT. 

Unrecorded  ANSWER:  The  Sendmail  subsystem  command  "Unrecorded"  is  not 
completely  implemented.  Items  marked  "Unrecorded"  may  be  left  out  of  journal 
catalogs  when  they  are  generated.  Eventually  such  an  item  will  not  be  given  a 
Journal  number  and  not  be  recorded  in  the  Journal. 

up:  the  statement  one  level  higher  and  preceding  a  given  statement  (i.e.,  its  source). 
In  the  illustration,  statement  lb  is  one  up  from  lb3;  statement  1  is  two  up  from 
lb3;  the  origin  is  three  up;  four  up  would  still  refer  to  the  origin.  See  also: 
illustration. 

uparrow:  t 

when  t  appears  in  an  expression  like:  tY:  it  refers  to  a  control  character  See 
CTRL-character. 

The  uparrow  command:  t  [TNLS  only]:  Typing  the  charactr  t  (uparrow)  at  the  herald  in 
the  BASE  subsystem  will  print  the  statement  that  is  back  from  the  statement  where  you  are 
located. 

TNLS  example: 

BASE  C:  t 

3b  Of  shoes  and  ships  and  ceiling  wax,  of  cabbages 
and  kings, 

BASE  C: 

Effects:  No  OK  is  required  for  the  execution  of  this  command.  After  execution,  you  are 
located  at  the  first  character  of  the  statement  printed. 

The  uparrow  command  in  Help  (for  advanced  users):  See  uparrow  (HELP). 

Uparrow  to  expand  Sendmail  distribution:  See  expanded  (SENDMAIL). 
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Update  File:  The  command  "Update"  incorporates  your  modifications  into  your 
file. 

OK:  Update  File  OK:  The  command  "Update  File"  permanently  incorporates  the  changes  you 
have  made  in  a  file.  A  new  version  of  the  file  is  created  that  includes  the  changes  you  have 
made.  The  old  version  will  look  as  the  file  did  after  the  previous  update.  At  any  time,  before 
you  use  the  Update  command,  you  may  discard  all  changes  with  the  Delete  Modifications 
command. 

Delete  Modifications  command:  See  Delete  Modifications. 

Compact:  Update  File  Compact  OK:  The  command  "Update  File  Compact"  updates  your  file 
is  such  a  way  as  to  use  the  file  space  efficiently.  This  saves  on  disk  pages,  but  takes  more 
computer  time  to  execute.  See  also:  file,  modifications,  version. 

TNLS  example: 

BASE  C:  Update  C:  File  OK/C:  Compact  OK: 

BASE  C: 

» 

Old:  Update  File  Old  (version)  OK:  The  command  "Update  File  Old”  incorporates  the  changes 
you  have  made  into  the  old  version.  This  is  a  bit  dangerous;  if  any  problems  occur  during  the 
Update,  you  may  not  have  a  prior  version  to  back  up  to.  It  is  useful  if  you  are  short  on  disk 
space.  See  also:  file,  modifications,  version. 

Rename:  Update  File  Rename  (filename)  CONTENT  OK:  The  command  "Update  File 

Rename"  allows  you  to  update  to  a  file  with  new  name  instead  of  a  new  version  of  the  current 
file.  You  must  specify  a  name  for  the  new  file.  See  also •  file,  modifications,  version. 

Effects:  You  may  duplicate  a  file  in  another  directory  by  giving  it  a  name  that  begins  with 
the  name  of  the  second  directory.  This  will  only  work  if  you  have  the  right  to  write  on 
that  directory.  See  also:  access. 

Update  (to  item  number(s))  CONTENT  OK:  The  Sendmail  subsystem 
command  "Update"  allows  you  to  inform  the  Journal  catalog  system  that  this 
item  updates  another  already  in  the  Journal  catalog.  Type  in  the  number  of  the 
old  document  for  CONTENT. 

Journal  number:  See  number  (SENDMAIL). 

CONTENT:  See  content. 

Use:  See  also:  How. 

Accumulator:  Use  Accumulator  (number)  CONTENT  OK:  Use  the  Calculator  subsystem 
command  "Use  Accumulator"  to  specify  the  number  accumulator  you  wish  to  use  for 
CONTENT.  The  calculator’s  Show  Accumulator  command  will  tell  you  the  number.  See  also: 
accumulator.  Show  Accumulator  (CALCULATOR),  CONTENT. 

Saved:  Use  Saved  (Accumulators)  OK:  Use  the  Calculator  subsystem  command  "Use  Saved"  to 
insert  a  number  calculated  in  your  last  calculator  session  instead  of  the  current  session.  See 
also:  accumulator. 

User  computer:  A  computer  site  on  the  ARPANET  that  is  not  a  Server.  See 
Server. 

user- profile:  A  record  of  how  NLS  is  Fitted  to  your  use  patterns  in  various  ways. 
A  user-profile  is  a  data  structure  used  by  a  command  interpreter  while  interacting 
with  the  user,  which  describes  to  the  interpreter  how  the  system  should  appear  to 
this  user. 

User: 
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Name:  Username:  See  directory. 

USER  C:  Useroptions  SUBSYSTEM:  See  useroptions. 

userprograms:  See  programs. 

user  computer  on  the  ARPANET:  See  user. 

USerguideS:  The  directory  "userguides"  houses  hardcopy  formatted  source  files 
for  user  guides  and  the  locator  file. 

locator  file:  The  file  named  <  userguides,  locator,  >  is  an  outline  of  documents.  In  Locator,  links 
are  arranged  to  lead  you  easily  to  useful  views  of  actual  documents.  Branch  1  of  locator 
instructs  you  how  to  use  locator.  Further  guidance  appears  as  needed  in  the  subject  files.  You 
cannot  currently  access  the  locator  file  with  the  Help  command.  In  TNLS,  say  "Print  Branch 
userguides,  locator,  1  .1"  followed  by  a  carriage  return.  In  DNLS  say  "Jump  (to)  Link 
userguides,  locator,  "  followed  by  CA. 


username:  See  directory. 

Useroptions  subsystem:  You  can  alter  how  you  interact  with  NLS  to  fit  your 
own  equipment,  use  patterns,  and  style  by  specifying  the  parameters  controlled  by 
the  Useroptions  subsystem.  The  effects  of  Useroptions  commands  hold  for  future 
NLS  sessions,  until  you  use  the  commands  again  to  change  them  specifically.  See 
also:  SUBSYSTEM,  Heralds. 

Commands  available  in  the  useroptions  Subsystem- 
Control  characters:  See  Control  (USEROPTIONS). 

Currentcontext  (length)  NUMBER  OK:  See  Currentcontext  (USEROPTIONS). 

Entry  Subsystem/Program  ...  :  See  Entry  (USEROPTIONS). 

Exclude  Subsystem/Program  ...  :  See  Exclude  (USEROPTIONS). 

Execute  (command  in)  SUBSYSTEM:  See  execute. 

External  (names  link  file  address)  CONTENT  OK:  See  External  (USEROPTIONS). 
Feedback  FEEDSPECS  OK:  See  Feedback  (USEROPTIONS). 

Goto  SUBSYSTEM  OK:  .See  Goto. 

Herald  [affects  TNLS  only]:  HERALDSPECS  OK:  See  Herald  (USEROPTIONS). 

Include  Subsystem/Program  ...  :  See  Include  (USEROPTIONS). 

Return  (ring  entries)  CONTENT  OK:  See  Return  (USEROPTIONS). 

Filereturn  (ring  entries)  CONTENT  OK:  See  Filereturn  (USEROPTIONS). 

Name  (delimiters  defaults):  See  Name  (USEROPTIONS). 

OKREPEAT  <CTRL-B>:  See  OKREPEAT. 

Printoptions  PRINTSPECS  CONTENT  OK:  See  Printoptions  (USEROPTIONS). 

Prompt  OK:  See  Prompt  (USEROPTIONS). 

Quit:  See  Quit. 

Recognition  (mode)  RMODE  OK:  See  Recognition  (USEROPTIONS). 

Reset:  See  Reset  (USEROPTIONS). 

Show:  See  Show  (USEROPTIONS). 
semicolon:  See  semicolon . 
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Startup  (commands  branch  address)  CONTENT  OK:  See  Startup  (USEROPTIONS). 

Viewspecs  Default  VIEWSPECS  OK:  See  Viewspecs  (USEROPTIONS). 

USerprOgrams  library:  In  directory  PROGRAMS  certain  compiled  user-program 
files  are  supported  and  maintained  by  ARC  staff.  By  using  the  Load  Program 
Command  in  the  Programs  Subsystem,  you  can  make  user-subsystems  to  add  to 
your  NLS  commands,  content-analyzers  to  add  to  your  filtering  capabilities,  and 
sort-keys  to  increase  your  ways  of  sorting.  If  any  of  these  programs  does  not 
work,  send  a  message  to  FEEDBACK.  See  also:  programs,  loading. 

Usersubsystems  library:  See  Usersubsystems. 

Content-anaiyzers:  See  Content-analyzers. 

Runable  Programs  (REL  files):  SeeRunable. 

Sort-Keys  library:  See  Sort-Keys. 

Attachable  subsystems  already  loaded:  See  Attachable. 

Sequence  Generators:  See  Sequence. 

Class-ll  and  III  user-programs:  in  Directory  XPROGRAMS  SeeClass-ll. 

Usersubsystems  library:  The  list  of  user-programs  in  directory  "programs" 
that  can  be  loaded  as  additional  subsystems.  See  also:  loading  (PROGRAMS). 

Format:  See  Format. 

Message:  See  Message. 

Modify:  See  Modify. 

Publish:  See  Publish. 
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V  ViewspeC:  defer  recreating  display:  "Do  not  re-create  display  screen  when  the 
contents  change."  v  defers  display  re-creation  until  you  use  the  f  viewspec.  The 
suppression  of  re-creation  continues  until  you  change  back  to  viewspec  u.  This 
viewspec  saves  time  when  the  response  is  slow,  but  be  cautious;  you  must  edit 
from  the  bottom  of  the  screen  to  the  top  or  it  may  look  like  you  are  at  a  different 
place  than  you  really  are.  See  also:  DNLS,  u,  f. 

V  — colon:  V:  VIEWSPECS:  The  prompt  V:  asks  you  to  specify  viewspecs  by 

typing  one  or  more  single-letter  codes  that  control  the  appearance  of  your  view. 
When  you  have  typed  all  the  viewspecs  you  want,  conclude  with  CA.  If  you  do 
not  want  to  change  your  view  of  your  file,  type  a  CA  without  any  viewspecs. 
You  can  turn  the  VIEWSPEC  field  off  in  all  commands  by  the  Useroptions 
Viewspecs  Off  command. 

VIEWSPECS:  See  viewspecs . 

Useroptions  Viewspecs  Off  command:  See  viewspecs  (USEROPTIONS). 

VARIABLES:  ALL  CAPITAL  LETTERS:  words  used  in  the  command  syntax 
notation  that  tell  you  the  alternatives  for  that  part  of  the  command.  Some  stand 
for  a  list  of  nominals,  others  for  a  list  of  two-to-three  alternative  operands.  For 
example,  the  variable  STRUCTURE  is  a  nominal  which  could  be  a  statement, 
branch,  group,  etc.  The  variable  SOURCE  is  an  operand  (such  as  file)  that  you 
specify  to  show  where  you  want  something  to  happen.  See  also:  nominal, 
operand. 

SUBSYSTEM:  See  subsystem. 

DESTINATION:  See  destination. 

SOURCE:  See  source. 

CONTENT:  See  content. 

ADDRESS:  See  address. 

TYPEIN:  See  typein. 

STRING:  See  string. 

STRUCTURE:  See  structure. 

LEVEL-ADJUST:  See  level -adjust. 

VIEWSPECS:  See  viewspecs. 

OPTION:  See  optional. 

BUG:  5eebug. 
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OK:  See  ok. 

verb  — nominal:  a  term  to  describe  the  verb  followed  by  a  nominal  (noun-like  word) 
combination  that  begins  NLS  Base  commands.  When  you  are  prompted  with  a 
C:  ,  type  a  verb-nominal  specifying  "do  this"  followed  by  operands  which  specify 
"to  what  and  where."  See  also:  prompts,  operands. 

verbs  in  the  BASE  subsystem  by  classes:  See  commands  (BASE). 

nominals:  Seenominals. 

verb-noun:  See  verb-nominal . 
verb:  See  verb-nominal. 

Verify  File  OK:  The  command  "Verify  File"  will  check  certain  aspects  of  your 
loaded  file.  If  the  file  is  bad,  the  message  Bad  File  will  appear.  Sometimes  this 
message  appears  when  a  command  cannot  be  executed  because  of  file  difficulties. 
The  Verify  file  command  does  not  check  every  problem  with  the  file,  but  when  it 
reports  a  bad  file,  you  have  serious  problems.  If  the  file  is  not  bad,  it  will  say 
"Successful,  internal  structure  is  OK". 

BAD  FILE:  If  this  message  is  printed,  immediately  type  "control-C  reset  carriage-return": 
<  CTRL-C  >  reset  <  CR  >  and  try  the  following.  In  TENEX,  type  NLS  <  CR  >  .  Load  the  file 
and  use  the  Update  File  Compact  command.  If  the  Verify  File  command  still  says  BAD 
FILE,  two  courses  of  action  are  listed  here.  See  also:  TENEX. 

Load  an  old  version:  You  may  have  to  undelete  the  old  version.  You  can  undelete  old 
versions  by  using  the  Undelete  File  command  or  you  can  get  them  from  the  nightly 
dump  tape  by  linking  or  sending  a  message  to  the  computer  operator.  The  deleted  option 
in  the  Show  Directory  command  lists  Files  deleted  but  still  online  (not  yet  expunged).  If 
the  Verify  File  command  does  not  say  BAD  FILE  on  the  old  version,  then  type 
<  CTRL-C  >  reset  <  CR  >  and  delete  the  BAD  versions.  The  old  version  will  not  contain 
changes  you  have  made  since  the  last  time  you  used  the  Update  command.  See  also: 
Undelete,  Show  Directory,  Expunge. 

files:  See  files. 

version:  Aversion. 

Delete  File  command:  See  Delete  File. 

Create  a  new  empty  file  and  copy  into  it  the  good  structure  from  the  bad  File. 

Check  to  make  sure  all  structures  you  pointed  to  were  copied  into  the  new  File.  Use  the 
Update  File  Compact  command  on  the  File  just  created.  If  the  Verify  File  command  still 
says  BAD  FILE,  type  <  CTRL-C  >  NLS  <  CR  >  and  load  one  of  the  bad  Files.  Try  to 
determine  the  location  of  the  bad  spot  by  reading  selected  portions.  Often  the  problem  is 
in  a  single  statement,  usually  one  you  have  recently  written  on.  If  you  can  isolate  that 
statement  and  copy  the  good  parts  of  the  File  to  a  new  File,  you  can  save  your  work.  If 
you  use  the  command  Output  Terminal,  the  File  should  stop  printing  at  the  spot  that  is 
bad.  In  DNLS,  if  the  File  is  so  bad  that  it  will  not  display,  you  must  Simulate  TNLS  to 
do  this  process.  In  general,  use  Update  File  Compact  and  <  CTRL-C  >  NLS  <  CR  >  a  lot 
in  the  process  of  saving  a  bad  File. 

TNLS  example: 

BASE  C.  Verify  C:  File  OK: 

File  Verify  ;n  Progress 

Succesful,  internal  structure  is  OK 

BASE  C: 

or  it  could  look  like: 
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BASE  C:  Verify  C:  File 

File  Verify  in  Progress 

BAD  FILE 

BASE  C: 

VERSION:  serial  numbers  attached  to  successive  updates  of  the  same  file.  A  new 
version  is  usually  created  with  the  Update  File  command  and  can  be  created  with 
the  Copy  and  Move  File  commands.  Only  two  consecutive  versions  are  kept  in  a 
directory.  The  oldest  version  is  automatically  deleted.  The  version  number 
follows  the  semicolon  in  filenames.  See  also:  FILENAME. 

Update  File  command:  See  Update. 

Copy  File  command:  See  Copy  File. 

Move  File  command:  See  Move  File. 

viewing  contents  Of  files  on  DNLS  screen:  see  also:  reading.  When  you 
enter  DNLS,  your  initial  file  will  appear  in  your  file  display  area,  starting  with 
the  origin  statement  and  displaying  as  much  as  will  fit  on  the  screen.  Every  time 
you  go  to  a  new  location  in  some  file  (by  loading  or  creating  a  file  or  by 
jumping),  the  display  will  start  at  that  location  and  display  as  much  of  the  text  as 
fits.  When  you  have  a  particular  view  on  the  screen,  you  can,  with  NLS 
commands,  operate  upon  the  text  in  view  by  pointing  with  BUG  or  by  giving  an 
ADDRESS.  You  can  operate  on  the  text  not  in  view  by  giving  an  ADDRESS. 
A  new  window  can  be  made  by  inserting  an  edge.  You  get  around  in  files,  i.e., 
change  your  view,  by  jumping.  See  also:  initial,  window,  accessing,  Load, 
pointing,  BUG. 

Entering  DNLS:  See  to -get -DNLS. 

The  view  you  get  of  a  place  is  controlled  by  viewspecs:  You  can  change  the  kind  of  view 
you  want  by  manipulating  these:  See  viewspecs . 

Jumping  in  DNLS:  See  Jumping. 

Beginning  statement  in  work  area  and  your  location:  After  you  Jump  or  Load  (or  delete 
the  statement  at  the  top),  the  work  area  starts  with  the  new  statement  pointed  to  as  soon  as  the 
screen  is  re-created,  except  when  a  content  filter  pattern  obscures  that  statement.  In  the  latter 
case,  the  first  statement  that  passes  the  filter  appears  at  the  top  of  the  screen.  See  also: 
content- pattern,  filters. 

re-creating  the  display:  See  re-creating. 

viewing— commands:  jumping,  printing,  reading,  etc.  See  also:  show. 

<LINEFEED>:  <CTRL-J>:  See  LINEFEED. 

Load  File  CONTENT  OK:  See  Load. 

Output:  See  Output . 

Print  (in  TNLS):  See  Print. 

Jump  (in  DNLS):  See  jump. 

Reset  Content  (pattern):  See  Reset  Content. 

Reset  Viewspecs:  See  Reset  Viewspecs. 

Set  Content  (pattern):  See  Set  Content. 

Set  Viewspecs:  See  Set  Viewspecs. 


GLOSSARY 


169 


V 


Show  Viewspecs:  See  Show  Viewspecs  (BASE). 

TAB-command:  See  TAB-command. 
uparrow  r  [TNLSonly]:  Seeuparrow. 

These  3  commands  show  where  you  are: 
backslash  [TNLSonly]:  See  backslash, 
period  [  TNLS  only  ] :  See  period . 

'slash  [TNLSonly]:  See  slash. 

VIEWSPECS:  single-letter  codes  that  control  the  appearance  or  "view"  of  your 
files.  When  VIEWSPECS  are  allowed  in  a  command,  you  are  prompted  by 
"V:".  You  may  type  a  string  of  any  of  the  viewspec  codes,  terminated  by  OK. 
Type  just  an  OK  if  you  don’t  want  to  change  the  viewspecs.  Uppercase  viewspecs 
do  different  things  than  lowercase  viewspecs.  To  see  in  the  Help  command  the 
definitions  of  lowercase  viewspecs,  type  the  viewspec.  To  see  upper-case 
viewspecs,  preceed  the  viewspec  with  the  word  "capital-".  For  instance, 
capital-B. 

changing:  ways  of  changing  viewspecs.  See  changing, 
viewspec  categories  and  lists — 

clipping  viewspecs:  cut  off  lines  or  levels.  See  clipping, 
formatting  viewspecs:  change  layout.  See  formatting, 
display-control  viewspecs:  DNLS  only.  See  display-control. 

FILTER  viewspecs:  See  FILTER. 

content-analysis  and  sequence  generator  viewspecs:  See  content-analysis, 
codes:  list  of  viewspecs  in  alphabetical  order.  Seethe  NLS  cue  card. 

Viewspecs  Default  VIEWSPECS  OK:  The  Useroptions’  subsystem  command  "Viewspecs" 
allows  you  to  select  which  particular  viewspecs  you  want  to  be  in  force  when  you  begin  your 
next  NLS  sessions.  See  also:  Show  Viewspecs  (USEROPTIONS),  Reset  Viewspecs 
(USEROPTIONS). 

Effects:  You  select  the  viewspecs  to  be  in  effect  at  the  beginning  of  your  NLS  sessions. 
The  Base  command  Set  Viewspecs  will  change  viewspecs,  but  they  will  then  revert  to  the 
"Default"  set  next  time  you  login.  The  command  Reset  Viewspecs  will  return  viewspecs 
immediately  to  that  same  status.  Useroptions  Reset  Viewspecs  command  will  return  your 
"Default"  viewspecs  to  hjupmwyACEHJLP. 

Showing  Status  Of  Viewspecs:  The  command  "Show  Viewspecs"  will  allow  you 
to  see  the  viewspecs  presently  in  force  in  the  current  session.  The  Useroptions’ 
subsystem  command  "Show  Viewspecs"  shows  the  initial  viewspecs  for  successive 
NLS  sessions  (established  in  Useroptions). 

Visible:  a  continuous  STRING  of  printing  characters  (which  excludes,  for  example, 
spaces  and  carriage  returns).  Pointing  to  any  character  position  within  the  visible 
will  serve  to  point  to  the  entire  visible. 

trick:  See  trick. 
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W  ViewspeC:  show  all  lines  and  all  levels:  "Show  all  levels  and  all  lines  of  each 
statement."  Viewspec  w  changes  viewspecs  x,  a,  b,  d,  e,  q,  r,  and  t.  w  =  c  (show 
all  levels)  plus  s  (show  all  lines).  This  is  a  default  viewspec. 

Where  command  in  TENEX:  The  TENEX  command  "Where"  reveals  the 
terminal  (here  referred  to  as  "TTY")  number,  job  number,  and  current  subsystem 
of  any  user  currently  logged  in.  The  command  is: 

Where  (is  user)  USERNAME  <CR> 

USERNAME  =  type  the  person’s  login  name. 

<  CR  >  =  the  Carriage  Return  key  on  the  keyboard. 

TENEX  has  commandwords  and  noisewords  similar  to  NLS.  See  notation. 

recognition  of  TENEX  commands:  See  recognition -TENEX. 

Linking  may  have  bad  effects  on  the  jobs  of  users  in--:  NDNLS,  OUTPRC,  or  other 
special  subsystems;  EXEC  (TENEX),  TNLS,  NTNLS,  or  DNLS  are  usually  safe  for  linking. 
Don’t  connect  terminals  with  Printer,  Background,  System,  or  users  who  are  detached  (DET). 

window:  Sec  display. 

Windowing  and  DNLS  viewing:  See  viewing. 

word  — search:  "word"  =  w:  an  address  element  that  moves  you  to  the  next 
occurrence  of  that  word.  If  the  word  is  not  found  in  the  current  statement,  the 
search  will  go  on  to  the  next  statement  in  the  hierarchy,  and  so  on  to  the  end  of 
the  file.  After  you  use  a  word  search  in  an  ADDRESS,  if  you  want  to  jump  to  a 
subsequent  occurrence  of  that  word,  use  the  TAB  command.  See  also: 
TAB-command. 

further  goodies —  "word"— 2ws.-  The  "w"  may  be  preceded  by  a  number  N,  indicating  the 
Nth  occurrence  of  the  word.  The  search  will  take  place  only  within  N  statements  if  w  is 
followed  by  a  Number  N  and  an  V.  The  example  on  the  top  line  would  specify:  "Jump  to 
the  2nd  occurrence  of  word  as  a  word  in  this  statement  only  (1  statement  is  the  default  if 
Number  is  omitted  before  "s"). 

Word:  a  continuous  string  of  letters  and/or  numbers.  Pointing  to  any  character 
within  the  word  will  serve  to  point  to  the  word. 

Trick:  See  trick. 

word:  Backspace  Word:  BW:  The  key  you  type  <CTRL-W>  to  delete  (roughly 
speaking)  the  word  you  just  typed  in.  More  exactly,  to  back  up  through  the 
following  types  of  characters  in  the  order  listed:  any  invisible  characters,  any 
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punctuation  or  special  characters,  and  then  any  numbers  and  letters.  In  TNLS, 
BW  will  show  up  typed  as  a  backarrow  _  .  In  DNLS  (some  DNLS  keyboards 
have  a  BACK  SPACE  WORD  key  which  serves  for  BW)  the  word  simply 
disappears.  Down  and  up  on  the  two  leftmost  buttons  of  the  mouse  specifies  a 
BW.  You  may  use  BW  as  many  times  as  you  like.  See  also:  control-character . 

workstation:  a  human  engineered  combination  of  desk,  display(s),  input  and 

pointing  devices,  (perhaps  integrated  telephone  and  intercom  systems,  audio 
input/output  devices,  micro-film  readers)  and  so  forth. 

write  access  to  files:  the  capability  of  writing  on  a  file.  Whether  or  not  other 
people  initially  have  the  capability  to  write  on  one  of  your  files  varies  with  the 
NLS  system.  At  Office- 1,  initially  only  you  can  write  on  your  files.  If  you  want 
to  open  files  to  others  for  writing,  you  must  use  the  command  Set  NLS 
(protection  for  files)  Public.  You  may  ask  the  operator  to  open  all  files  in  your 
directory  to  a  group  of  co-workers  or  to  all  users.  In  that  case,  you  can  protect  a 
particular  file  with  the  command  Set  NLS  (protection  for  files)  private.  See  also: 
writing,  write  (CALCULATOR),  privacy. 

Write  (new)  File  CONTENT  OK:  The  Calculator  subsystem  command  "Write" 
will  create  a  new  file  named  whatever  FILEADDRESS  you  specify  for 
CONTENT.  It  will  be  an  exact  copy  of  your  Calculator  file.  The  Calculator 
depends  on  the  information,  structure,  and  format  in  the  Calculator  file.  It  is  not 
possible  to  use  the  Calculator  if  this  structure  or  format  has  been  changed  in  any 
way.  A  new  file  may  be  edited  in  any  way  you  desire.  "Write  File"  also  clears 
the  Calculator  file  of  all  entries.  Therefore  any  subsequent  "Write  File"  makes  a 
new  file  containing  only  those  entries  since  the  most  previous  "Write  File".  See 
also:  File  (CALCULATOR),  CONTENT,  FILEADDRESS,  file. 

Writing,  creating  and  modifying  information:  In  NLS,  you  can  create  new 
files,  copy  all  or  selected  parts  of  existing  files,  insert  text  by  typing  into  existing 
files,  and  edit  existing  text.  Access  for  these  operations  may  be  restricted.  See 
also:  information. 

Use  the  Insert  command  to  add,  duplicate,  or  create  information.  See  insert. 

handling  whole  files:  NLS  provides  many  commands  that  deal  with  whole  files  allowing  you  to 
make  changes,  erase  changes  made,  send  files  to  people,  delete  them,  and  transfer  files  from  one 
directory  or  site  to  another,  and  return  to  recent  files  you  have  accessed. 

Updating  modifications:  See  Update. 

correcting  errors:  See  correcting. 

privacy  provisions:  See  privacy. 

commands:  See  modifying-commands. 

writing  programs:  Programs  are  written  in  the  BASE  subsystem.  There  are  two 
ways  of  writing  a  program.  One  is  by  inserting  a  list  of  commands  to  be 
processed  by  the  BASE  subsystem's  Process  Commands  command.  The  other  is 
by  using  the  L10  and  CML  software  languages  in  which  NLS  is  written.  The 
"Process  Commands"  program  does  not  allow  conditional  "IF"  type  functions. 
With  L10,  you  can  write  simple  content-analyzer  patterns  for  use  with  FILTERS 
or  you  can  write  whole  systems. 

The  Process  (commands  in)  STRUCTURE  command:  See  Process  (BASE). 
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content-analyzer:  See  content-analyzer, 
source-code:  See  source -code. 

L10:  programming  language  See  LI 0. 

CML:  Command  Meta  Language  SeeCML. 

Procedures  (routines)  you  can  use  to  write  programs:  Procedures  are  sub-routines  whicn 
can  be  "called"  by  any  program  to  do  it’s  thing.  See  also:  Procedure,  NLS,  xprocs. 


X  ViewspeC:  show  one  line  and  one  level  only:  "Show  only  one  level  and  one  line 
of  each  statement."  Normally,  all  levels  and  lines  appear  (standard  viewspec  w); 
x  changes  your  view  to  the  first  line  only  of  top-level  statements  only.  Example: 
show  the  first  two  lines  of  3  levels  by  using  the  string  xbbr.  Also,  x  frequently 
gives  a  handy  table  of  contents  of  a  document. 

X:  x  command:  See  multiply. 

XDOC:  acronym  for  external  document:  (as  opposed  to  a  document  journalized  via 
the  Sendmail  Subsystem  online).  You  may  reserve  XDOC  numbers  for  items  that 
will  be  indexed  in  the  ARC  Catalog  system,  but  will  not  appear  as  an  online  file 
in  the  Journal.  See  also:  Numbering  (SENDMAIL). 

XPROGRAMS:  5eeclass-ii. 

XXX:  (for  Wheels  and  Operators  only,  not  documented  here):  a  special  subsystem  of 
NLS. 


y  Viewspec:  blank  line  between  statements  on:  "Place  a  blank  line  between 
statements."  Invoking  viewspec  z  removes  blank  lines. 
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Z  ViewspeC:  blank  line  between  statements  off:  "Don’t  place  a  blank  line  between 
statements."  This  turns  off  viewspec  y  (blank  lines  on).  This  is  a  default 
viewspec. 


